---
title: Runbook — STARTUP_VALIDATION_FAILED (환경 변수 검증 실패)
category: INTERNAL
error_codes: [STARTUP_VALIDATION_FAILED]
severity: P1
owner: oncall
last_updated: 2026-06-15
status: stub
---

# Runbook: STARTUP_VALIDATION_FAILED (`runbook://startup/validation-failed`)

## Symptoms

- Container exits with code 78 (env validation failure exit)
- Structured log with `error.code=STARTUP_VALIDATION_FAILED`, `startup.phase=env-validation`

## Diagnosis

- Check which required env variable is missing or malformed
- Review container environment and secrets injection

## Action

- Supply missing environment variables to deployment
- Verify secrets are correctly mounted / injected

## Escalation

- P1: app cannot start; coordinate with deployment/secrets team

---

> **Stub**: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)