[오류해결] Next.js yarn start 오류 [Error: ENOENT: no such file or directory, open '~/.next/BUILD_ID']

오류 발생

 

Next.js 프로젝트를 실행하기 위해 yarn build 이후 yarn start를 입력하면 아래와 같은 오류가 발생했다.
yarn start를 실행하면 BUILD_ID 파일을 찾을 수 없다는 에러 메시지가 나온다.

$ yarn start  
yarn run v1.22.21  
$ next start  
   ▲ Next.js 14.1.0  
   - Local:        http://localhost:3000  

\[Error: ENOENT: no such file or directory, open '/Users/iksflow/workspace/backup-peace/.next/BUILD\_ID'\] {  
  errno: -2,  
  code: 'ENOENT',  
  syscall: 'open',  
  path: '/Users/iksflow/workspace/backup-peace/.next/BUILD\_ID'  
}  
error Command failed with exit code 1.  
info Visit [https://yarnpkg.com/en/docs/cli/run](https://yarnpkg.com/en/docs/cli/run) for documentation about this command.

 

원인 분석

 

yarn build에 실패한 채 yarn start를 실행한 것이 문제였다.

 

문제 해결

 

yarn build 시 오류가 발생하는 부분을 수정한 다음, 다시 빌드를 완료하고 yarn start를 실행하니 해결되었다.
Next.js는 yarn build로 빌드에 성공하면 .next/BUILD_ID 파일이 생성되고 실패하는 경우 생성되지 않는다.
내 경우엔 빌드할 때 코드에 오류가 발생한 부분이 있어서 빌드에 실패했지만 이를 인지하지 못한 채 빌드에 성공한 줄 알고 yarn start를 실행했던 것이 원인이었다.
빌드에 실패해서 BUILD_ID 파일이 생성되지 않았기 때문에 yarn start에서도 당연히 오류가 발생하던 것이었다.

 

요약

 

• yarn build에 실패하면 BUILD_ID 파일이 생성되지 않는다.
• yarn start는 BUILD_ID 파일이 없으면 실패한다.