--- title: Runbook — DB_SERIALIZATION_FAILURE (직렬화 실패) category: CONFLICT error_codes: [DB_SERIALIZATION_FAILURE] severity: P3 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: DB_SERIALIZATION_FAILURE (`runbook://db/serialization-failure`) ## 증상 - HTTP 409, `error.code=DB_SERIALIZATION_FAILURE`. - SQLState 40001. 동시 트랜잭션 경합이 심하다. ## 진단 - DB 트랜잭션 격리 수준을 확인한다. - 동시성이 높은 hot row·hot table을 찾는다. ## 조치 - 클라이언트는 지수 백오프로 다시 시도한다(retryable=true). - 급증이 이어지면 트랜잭션 범위를 줄인다. ## 에스컬레이션 - 직렬화 실패 비율이 5%를 넘는 상태가 이어지면 DBA에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.