--- title: Runbook — DB_DEADLOCK (데드락) category: CONFLICT error_codes: [DB_DEADLOCK] severity: P2 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: DB_DEADLOCK (`runbook://db/deadlock`) ## 증상 - HTTP 409, `error.code=DB_DEADLOCK`. - Postgres 로그에 SQLState 40P01이 있다. ## 진단 - 교착이 생길 때 `pg_locks`와 `pg_stat_activity`를 본다. - 충돌하는 트랜잭션의 락 순서를 찾는다. ## 조치 - 클라이언트는 다시 시도한다(retryable=true). - 반복되면 코드의 락 순서를 고친다. ## 에스컬레이션 - 교착 비율이 트랜잭션의 1%를 넘는 상태가 이어지면 DBA에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.