local 오류 원인 분류

개발 서버가 안 뜰 때 외부 조건부터 점검하기

코드 수정 전에 설치 상태, 런타임 버전, 포트, 환경 변수를 확인하면 원인을 빠르게 좁힐 수 있습니다.

install

의존성 재설치

node_modules와 락 파일 상태가 꼬였는지 보고 캐시 정리 뒤 다시 설치합니다.

Cannot find module 대응
runtime

Node 버전 확인

프로젝트가 요구하는 Node.js 버전과 현재 터미널의 버전이 같은지 맞춥니다.

node-gyp 오류 축소
port

3000번 점유 해제

EADDRINUSE가 보이면 실행 중인 프로세스를 종료하거나 다른 포트로 개발 서버를 띄웁니다.

서버 기동 복구
env

환경 변수 대조

.env.local, 배포 환경, 코드의 process.env 이름이 같은지 오타까지 확인합니다.

런타임 실패 예방
로컬 오류 분리

새 프로젝트에서도 같은 순서로 확인하면 로컬 설정 문제와 실제 코드 오류를 분리해서 볼 수 있습니다.