409 Conflict는 요청이 대상 리소스의 현재 상태와 충돌해 완료할 수 없었다는 뜻입니다. 클라이언트가 충돌을 해결하고 요청을 다시 보낼 수 있을 수도 있으므로, 응답에는 충돌의 원인을 파악할 수 있을 만큼의 정보가 담겨야 합니다.
PUT과 PATCH에서 가장 흔합니다. 두 사용자가 같은 문서를 편집하거나, 클라이언트가 저장된 것보다 오래된 버전을 업로드하거나, API가 이미 존재하는 레코드의 생성을 거부하는 경우입니다. WebDAV에서는 상위 컬렉션이 없을 때 MKCOL과 PUT이 409를 반환합니다.
If-Match를 사용한 조건부 요청이라면 표준 응답은 412 Precondition Failed이며, 409는 서버가 스스로 감지한 충돌을 다룹니다.
응답 예시
HTTP
HTTP/1.1 409 Conflict
Date: Fri, 06 Nov 2026 10:15:32 GMT
Content-Type: application/problem+json
Content-Length: 99
{"title":"Edit conflict","detail":"The document was changed by another user (current version: 7)."}SEO 및 리디렉션 검사
409는 API와 편집 작업 흐름에서 쓰는 코드입니다. 크롤러는 GET으로 페이지를 가져오므로 공개 페이지가 409를 반환해서는 안 되며, 409를 반환하면 4xx 오류로 취급되어 색인되지 않습니다.
주요 원인과 사용 사례
- 두 사용자가 같은 레코드를 저장했고, 두 번째 저장이 거부되었습니다.
- 클라이언트가 이미 존재하는 사용자, 파일 또는 다른 리소스를 생성하려고 합니다.
- 클라이언트가 현재 버전보다 오래된 파일 버전을 업로드합니다.
- WebDAV
MKCOL이나PUT이 상위 폴더가 존재하지 않는 폴더를 대상으로 합니다.