npm run dev는 package.json의 script를 실행하고, 포트와 설정 파일이 개발 서버 동작을 바꾼다
서버 실행 문제는 명령, 포트, 설정, 환경 변수 중 어느 층에서 달라졌는지 나눠 보면 빠르게 좁혀진다.
| 층 | 대표 입력 | 영향 | 확인 방법 |
|---|---|---|---|
| 실행 명령 | npm run dev | package.json의 dev script 실행 | scripts.dev 값 확인 |
| 포트 | PORT=3001 또는 --port | localhost 접속 주소 변경 | 터미널에 출력된 URL 확인 |
| Next 설정 | next.config.ts | remotePatterns, 실험 옵션, 빌드 동작 변경 | 설정 변경 후 서버 재시작 |
| 환경 변수 | .env.local | 무접두사는 서버 전용, NEXT_PUBLIC_은 브라우저 공개 | next.config.ts env 대신 .env.local 사용 |
| 브라우저 | http://localhost:3000 | 현재 실행 중인 앱 확인 | 주소와 포트가 로그와 일치하는지 확인 |