Troubleshooting

자주 발생하는 빌드 오류

개발 중 발생하는 Netlify 빌드 오류들과 그 원인, 해결 방법을 정리합니다.
로컬에서는 성공해도 Netlify에서 실패할 수 있습니다!

FILE NOT FOUND

오류 1: 파일 누락 (git 미추가)

Module not found: Can't resolve '@/lib/auth'

원인: 파일이 git에 추가되지 않았습니다. 로컬엔 있지만 원격 저장소엔 없는 유령 파일입니다.

git add src/lib/auth.ts
git commit -m "fix: auth.ts 파일 복구"
git push

TYPE MISMATCH

Type 'string | undefined' is not assignable to 'string'

원인: Optional 필드(?)를 필수 필드에 할당하려 할 때 발생합니다.

// 방법 1: null 체크 추가
if (!authResult.userId) {
  return error('User not found');
}

FILE LOCKED

EPERM: operation not permitted, rename DLL

원인: Prisma Studio나 개발 서버가 파일을 잡고 있어서 빌드가 실패합니다.

# 모든 Node 프로세스 종료
taskkill /F /IM node.exe

INVALID SECRET

원인: 파일마다 다른 Secret Key를 사용하고 있습니다. 열쇠가 다르면 문을 열 수 없습니다.

const JWT_SECRET = process.env.JWT_SECRET || 'dev-key';

WRONG BRANCH

Changes not reflected in deployment URL

원인: 배포가 연결된 main 브랜치가 아닌, 다른 브랜치(develop 등)에 푸시했습니다.

# 1. 메인 브랜치로 이동
git checkout main

# 2. 변경사항 병합
git merge develop

# 3. 메인에 푸시 (배포 트리거)
git push origin main