오류는 메시지보다 발생 위치와 재현 조건으로 먼저 좁힌다
설치, 컴파일, 런타임, 배포 오류는 확인해야 할 증거가 다르다. 한 번에 고치려 하지 말고 위치를 나누면 해결 순서가 보인다.
| 발생 위치 | 대표 메시지 | 먼저 볼 증거 | 첫 조치 |
|---|---|---|---|
| 설치/의존성 | Cannot find module, EACCES, node-gyp | lock 파일, Node 버전, 권한 | 버전 고정 후 재설치 |
| 개발 서버 | EADDRINUSE, env missing | 포트 점유, .env.local | 프로세스 종료 또는 포트 변경 |
| 컴파일 | Type error, Module not found | import 경로, 타입 정의 | 오타와 대소문자 확인 |
| 런타임/SSR | Hydration failed, undefined.map | 서버/클라이언트 값 차이 | 클라이언트 전용 코드 분리 |
| 배포 | Build Failed, 500 | Vercel build/runtime log | 로컬 프로덕션 빌드 재현 |