TechFeedTechFeed
409클라이언트 오류(4xx)

409 Conflict — 충돌

요청이 리소스의 현재 상태와 충돌해 처리할 수 없다는 응답입니다. 동시성·중복 생성에서 주로 발생합니다.

언제 발생하나

이미 존재하는 리소스 중복 생성, 낙관적 잠금(버전 불일치) 충돌, 동시 수정에서 발생합니다.

실무 대응

  1. 중복 생성이면 먼저 존재 여부를 확인하거나 upsert로 처리합니다.
  2. 낙관적 동시성은 버전/ETag를 비교해 충돌 시 최신 상태를 다시 읽고 재시도합니다.
  3. 사용자에게 충돌 사실과 해결 방법(새로고침 후 재시도 등)을 안내합니다.
💡 실무 메모: DB unique 제약 위반을 409로 매핑하면 클라이언트가 의미를 명확히 알 수 있습니다.

관련 코드·에러

관련 가이드

깃허브 액션, 동시성, 진행 중 취소, 대기 줄 | 같은 브랜치 푸시가 분을 두 번 깎을까?캐시 컨트롤, s-maxage, 스테일 리밸리데이트, CDN | 배포 직후 옛 페이지가 남는 이유는?낙관적 락, 비관적 락, Redis 분산 락, version | 동시 재고·결제는 어떻게 막나?