Vercel/Netlify env 문제는 “없는 값”보다 environment와 scope를 먼저 확인해야 합니다

Vercel과 Netlify 환경 변수 오류를 environment, build/runtime, deploy context 기준으로 나눠 보는 메모.

Vercel이나 Netlify에서 env 문제가 날 때 “값이 없다”로 바로 결론내리기보다 environment와 scope를 먼저 봐야 합니다. Vercel은 Production/Preview와 Build Step/Function 실행 위치가 중요하고, Netlify는 deploy context와 Builds scope가 중요합니다. 그래서 variable name, branch, deployment type, build command, runtime path, exact log line을 같이 적어야 원인을 좁히기 쉽습니다.