설치 오류는 의존성, 버전, 권한, 네트워크를 차례로 지운다
npm install과 개발 서버 오류는 원인이 섞여 보인다. 증상을 기준으로 첫 확인 지점을 정하면 불필요한 삭제와 재설치를 줄일 수 있다.
| 증상 | 의심 원인 | 확인할 것 | 해결 방향 |
|---|---|---|---|
| Cannot find module | 누락/손상된 의존성 | package.json, lock 파일 | node_modules 삭제 후 재설치 |
| node-gyp 오류 | 네이티브 빌드 도구/Node 버전 | Node, Python, compiler | 프로젝트 권장 Node로 전환 |
| EACCES | npm 캐시/전역 경로 권한 | ~/.npm, 전역 설치 경로 | 소유권 수정, sudo 설치 회피 |
| EADDRINUSE | 포트 점유 | 3000번 프로세스 | 프로세스 종료 또는 다른 포트 |
| 설치 지연/실패 | 레지스트리/프록시/VPN | 네트워크, registry 설정 | 네트워크 변경 후 재시도 |