---
title: Runbook — MIGRATION_FAILED (DB 마이그레이션 실패)
category: INTERNAL
error_codes: [MIGRATION_FAILED]
severity: P1
owner: oncall
last_updated: 2026-06-15
status: stub
---

# Runbook: MIGRATION_FAILED (`runbook://migration/failed`)

## Symptoms

- Container exits with code 70 (migration failure exit)
- Structured log with `error.code=MIGRATION_FAILED`, `startup.phase=migration`
- App refuses to start (fail-fast)

## Diagnosis

- Check Flyway migration log for which script failed and why
- Review latest migration script for SQL errors

## Action

- Fix migration script or roll back to previous migration version
- Run migration manually in repair mode if checksum mismatch

## Escalation

- P1 immediate: app cannot start until migration is resolved

---

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