DEV WIKI
인프라 · 기술

환경 변수

환경 변수는 프로세스가 시작될 때 이름과 값으로 전달되어 애플리케이션의 실행 설정을 구성하는 입력입니다.

정상 동작 조건

요약

환경 변수는 프로세스가 실행될 때 설정과 비밀값을 전달하는 입력입니다. 값이 없거나 다른 환경에 설정됐는지 확인할 때는 이름, 적용 환경, 빌드 시점과 서버 실행 시점을 구분해야 합니다.

확인 절차

환경 변수는 프로세스가 실행될 때 애플리케이션에 설정값을 전달합니다. 브라우저에 공개해도 되는 값과 서버에만 있어야 하는 비밀값을 먼저 구분해야 합니다.

확인할 범위

  • 변수 이름의 철자와 대소문자
  • 로컬·Preview·Production 중 적용 환경
  • 빌드 시 필요한 값인지 서버 실행 시 필요한 값인지
  • 공개 접두사가 필요한 프레임워크인지

비밀값을 Markdown, 로그, 화면과 클라이언트 번들에 기록하지 않습니다. 값을 바꾼 뒤에는 해당 환경에서 새 빌드 또는 재시작이 필요한지 확인합니다.

관련 플랫폼

Firebase

웹·모바일 애플리케이션에 인증, 데이터베이스, 저장소와 호스팅 기능을 제공하는 Google 플랫폼입니다.

GitHub Actions

GitHub 저장소의 이벤트를 기준으로 빌드, 테스트와 배포 작업을 실행하는 자동화 플랫폼입니다.

Vercel

Git 저장소의 프론트엔드와 서버 실행 코드를 빌드하고 배포하는 플랫폼입니다.

관련 오류

import.meta.env.VITE_* is undefined

Vite 애플리케이션에서 import.meta.env의 환경 변수가 undefined로 보일 때 변수 이름·모드·빌드 시점을 확인합니다.

참고 자료

process.env - Node.js Documentation (새 창에서 열림)

Node.js · 공식 자료 · 확인 범위: process-environment, runtime-configuration · 확인일: 2026-07-27