--- title: Runbook — STARTUP_VALIDATION_FAILED (환경 변수 검증 실패) category: INTERNAL error_codes: [STARTUP_VALIDATION_FAILED] severity: P1 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: STARTUP_VALIDATION_FAILED (`runbook://startup/validation-failed`) ## 증상 - 컨테이너가 코드 78로 끝난다(환경 변수 검증 실패 종료). - 구조화 로그 `error.code=STARTUP_VALIDATION_FAILED`, `startup.phase=env-validation`. ## 진단 - 빠졌거나 형식이 틀린 필수 환경 변수를 찾는다. - 컨테이너 환경과 secret 주입을 확인한다. ## 조치 - 빠진 환경 변수를 배포에 넣는다. - secret이 제대로 마운트·주입됐는지 확인한다. ## 에스컬레이션 - P1: 앱이 뜨지 못한다. 배포·secret 담당 팀과 맞춘다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.