204 No Content는 서버가 요청을 처리했으며 추가로 보낼 콘텐츠가 없다는 뜻입니다. 204에는 본문이 있을 수 없으며, 응답은 헤더 뒤의 빈 줄로 끝납니다. 그래도 헤더는 의미가 있습니다. 헤더는 요청한 작업이 적용된 뒤의 대상 리소스를 설명합니다.
API에서 성공한 PUT, PATCH, DELETE 요청, 분석 비콘, CORS 사전 요청(OPTIONS)에 대한 응답으로 흔히 쓰입니다. 브라우저가 204를 반환하는 URL로 이동하면 현재 페이지를 벗어나지 않습니다.
204는 기본적으로 캐시할 수 있습니다.
응답 예시
HTTP
HTTP/1.1 204 No Content
Date: Fri, 06 Nov 2026 10:15:32 GMT
Access-Control-Allow-Origin: https://app.example.com
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Content-Type, Authorization
Access-Control-Max-Age: 86400 SEO 및 리디렉션 검사
Google에 따르면 204는 Googlebot이 콘텐츠를 받지 못했다는 사실을 색인 생성 파이프라인에 알리며, Search Console에 소프트 404가 보고될 수 있습니다. 색인되기를 원하는 페이지에는 절대 204를 반환하지 마세요. 리디렉션 검사에서 체인 끝에 204가 있다면, 대개 그 URL이 페이지가 아니라 추적용 또는 API 엔드포인트라는 뜻입니다.
주요 원인과 사용 사례
- API가 리소스를 삭제하거나 업데이트했으며 반환할 내용이 없습니다.
- CORS 사전 요청(
OPTIONS)이 승인되었습니다. - 분석 엔드포인트나
navigator.sendBeacon()엔드포인트가 데이터를 받았다고 확인했습니다. - 잘못 설정된 라우트가 페이지 URL에 204를 반환합니다. 콘텐츠와 함께 200을 반환하거나, 제대로 된 404를 반환하세요.