Dev Server

개발 서버 실행 점검

dev 서버가 떠도 앱이 운영처럼 검증된 것은 아니다. 환경 변수 로딩, API 연결, HMR 상태, production build 오류를 별도로 봐야 한다.

01

환경 변수 분리

NEXT_PUBLIC_ 접두사가 붙은 값은 브라우저로 나가므로 비밀 키를 두지 않는다.

02

연결 실패 확인

dev 서버 시작 성공과 DB, API, 파일 경로 접근 성공은 별개의 조건이다.

03

build로 다시 검증한다

dev에서 보이지 않던 route generation, type, bundling 문제가 build에서 드러난다.

localhost
브라우저 진입점 포트 충돌이나 방화벽 문제를 먼저 분리한다.
다른 앱이 3000번을 쓰는지 본다.
env local
로컬 비밀 값 배포 환경과 값이 다를 수 있으므로 이름과 필수 여부를 문서화한다.
커밋하지 않는다.
public env
브라우저 노출 NEXT_PUBLIC_ 값은 번들에 들어갈 수 있다.
토큰을 넣지 않는다.
prod parity
운영과의 차이 dev의 느슨한 동작과 production 최적화는 다르다.
최종 확인은 build다.

비밀 값 · 포트 · 빌드 점검

비밀 값 브라우저로 나가면 안 되는 값이 NEXT_PUBLIC_으로 시작하지 않는가.
포트 서버가 뜬 포트와 브라우저가 여는 포트가 같은가.
빌드 dev 서버만 확인하고 production build를 생략하지 않았는가.

실행 구분

npm run dev
# 수정 확인 뒤
npm run build
npm run start