env update lifecycle
환경 변수 반영 시점
Vercel에 값을 추가해도 이미 배포된 클라이언트 번들이 자동으로 바뀌지는 않습니다. 어떤 환경에 저장했는지, 빌드 시점에 들어가는지, 런타임 서버 코드에서 읽는지를 나누어 확인해야 합니다.
범위 선택
Development, Preview, Production 중 실제 배포가 읽을 환경을 정확히 고릅니다.
빌드 반영
`NEXT_PUBLIC_` 값과 빌드 시점 참조 값은 새 빌드나 재배포가 필요합니다.
동작 확인
브라우저 노출 여부와 서버 로그를 같이 확인해 잘못 공개된 값이 없는지 봅니다.
서버 전용
API 라우트, 서버 컴포넌트, 서버 액션에서만 읽고 브라우저 번들에는 넣지 않습니다.
공개 가능
빌드 결과에 포함될 수 있으므로 공개 URL, 분석 ID처럼 노출 가능한 값만 둡니다.
이름에 `SECRET`, `TOKEN`, `PASSWORD`가 들어간 값은 기본적으로 서버 전용으로 취급하세요. 접두사를 붙이기 전에는 브라우저 개발자 도구에서 보일 수 있다는 사실을 먼저 떠올려야 합니다.