HTTP 상태 코드 조회

첫 자리 숫자가 응답의 분류를 결정합니다. 1xx(정보 응답)는 요청이 접수되었고 서버가 아직 처리 중임을 뜻합니다. 2xx(성공)는 요청이 올바르게 이해되어 처리되었음을 뜻합니다. 3xx(리다이렉션)는 보통 다른 URL로 이동하는 추가 동작이 필요함을 알립니다. 4xx(클라이언트 오류)는 잘못된 경로, 누락된 인증 정보, 지원하지 않는 메서드처럼 요청 자체에 문제가 있는 경우입니다. 5xx(서버 오류)는 요청은 정상이었지만 서버가 처리를 완료하지 못했음을 뜻합니다.

네 가지 모두 리다이렉트이지만 영구성 여부와 HTTP 메서드 유지 여부가 다릅니다. 301 Moved Permanently와 308 Permanent Redirect는 리소스가 영구히 이전했다는 뜻이므로 브라우저와 검색 엔진은 링크를 갱신해야 합니다. 302 Found와 307 Temporary Redirect는 일시적인 이동이므로 원래 URL을 계속 사용해야 합니다. 비교적 최신인 307과 308은 메서드와 본문이 그대로 유지됨을 보장하지만, 많은 클라이언트가 예전부터 301이나 302를 따라갈 때 POST를 GET으로 바꿔 왔습니다. 호환성이 중요한 영구 이전에는 301을, POST를 반드시 POST로 유지해야 한다면 308을 사용하세요.

404 Not Found는 지금 그 URL에 리소스가 없다는 사실만 알려 줍니다. 처음부터 없었는지, 옮겨 갔는지, 내일 다시 생길지는 말해 주지 않습니다. 410 Gone은 의도적이고 최종적인 선언으로, 그 자리에 있던 리소스를 대체 주소 없이 일부러 제거했다는 뜻입니다. 검색 엔진은 410을 더 강한 신호로 받아들여 해당 URL을 색인에서 더 빨리 제거하는 경향이 있습니다. 콘텐츠를 의도적으로 내릴 때는 410을, 단순 오타를 포함한 나머지 상황에는 404를 사용하세요.

5xx 코드는 문제가 사용자 쪽이 아니라 서버 쪽에 있다는 뜻입니다. 방문자 입장에서는 고칠 방법이 거의 없어 몇 분 뒤 새로 고침하는 정도가 전부이며, 요청 자체는 정상이었으므로 캐시를 지워도 소용이 없습니다. 개발자 입장에서 500 Internal Server Error는 처리되지 않은 예외를 뭉뚱그린 코드이므로, 진짜 원인은 상태 코드가 아니라 애플리케이션 로그나 스택 트레이스에 있습니다. 더 구체적인 5xx 코드가 범위를 좁혀 줍니다. 502와 504는 업스트림 서비스나 프록시를, 503은 대개 과부하나 점검 중임을 가리킵니다.

코드와 설명은 IANA HTTP 상태 코드 레지스트리와 그 근거가 되는 RFC 문서, 주로 RFC 9110에서 가져왔습니다. 전체 목록이 페이지에 함께 포함되어 있고, 필터링은 입력하는 즉시 브라우저 안에서만 실행됩니다. 서버로 전송되는 데이터도, 기록되는 검색 기록도 없으며 페이지를 한 번 불러온 뒤에는 오프라인에서도 그대로 작동합니다.