코드 번호·명칭·키워드로 즉시 검색하고 유사 코드를 비교하세요
자주 쓰는 상태 코드입니다. 위 검색창에 번호·명칭·키워드를 입력하거나 카테고리 칩으로 좁혀 보세요.
200
OK
요청이 성공적으로 처리되었습니다. 가장 일반적인 성공 응답입니다.
전형적 원인
GET·POST 등 요청이 정상 처리되어 응답 본문과 함께 반환될 때 발생합니다.
권장 대응
정상 응답입니다. 별도 조치가 필요 없습니다.
301
Moved Permanently
요청한 리소스가 새 URL로 영구 이동했습니다. 이후 요청은 새 주소를 사용해야 합니다.
전형적 원인
도메인 이전, URL 구조 변경, HTTP→HTTPS 강제 전환 등에서 발생합니다.
권장 대응
Location 헤더에 새 URL을 넣습니다. 브라우저·검색엔진이 영구 캐시하므로 SEO에 유리합니다.
관련 헤더:
400
Bad Request
요청 문법 오류나 잘못된 형식 때문에 서버가 요청을 이해할 수 없습니다.
전형적 원인
잘못된 JSON 본문, 누락·형식 오류 파라미터, 유효하지 않은 요청 구조 등에서 발생합니다.
권장 대응
요청 형식·필수 파라미터·Content-Type을 점검하고, 서버는 어떤 필드가 잘못됐는지 안내하세요.
401
Unauthorized
인증이 필요하거나 인증에 실패했습니다. "누구인지" 증명되지 않은 상태입니다.
전형적 원인
토큰·세션 누락·만료, 잘못된 자격 증명으로 로그인되지 않은 요청에서 발생합니다.
권장 대응
유효한 인증 정보(토큰·쿠키)를 첨부하고, WWW-Authenticate 헤더로 인증 방식을 안내하세요. (403과 구분: 401=인증)
관련 헤더:
403
Forbidden
서버가 요청을 이해했지만 접근 권한이 없어 거부합니다. "무엇을 할 권한"이 없는 상태입니다.
전형적 원인
인증은 되었으나 권한 부족, 차단된 IP, 비공개 리소스 접근 시도 등에서 발생합니다.
권장 대응
권한(역할·스코프)을 확인하세요. 인증을 다시 해도 접근이 열리지 않는 점이 401과의 차이입니다. (403=인가)
404
Not Found
요청한 리소스를 서버에서 찾을 수 없습니다.
전형적 원인
잘못된 URL 입력, 삭제된 콘텐츠, 만료된 링크, 오타난 경로 등에서 발생합니다.
권장 대응
경로를 재확인하고, 사용자에게는 커스텀 404 페이지와 홈·검색 유도 링크를 제공하세요.
429
Too Many Requests
일정 시간 동안 너무 많은 요청을 보내 요청 제한(rate limit)에 걸렸습니다.
전형적 원인
API 호출 한도 초과, 무차별 로그인 시도, 과도한 크롤링 등에서 발생합니다.
권장 대응
Retry-After 헤더를 확인해 대기 후 재시도하고, 클라이언트에 백오프·요청 제한을 구현하세요.
관련 헤더:
500
Internal Server Error
서버 내부에서 예상치 못한 오류가 발생해 요청을 처리할 수 없습니다. 가장 포괄적인 서버 오류입니다.
전형적 원인
처리되지 않은 예외, 코드 버그, DB 오류, 잘못된 서버 설정 등에서 발생합니다.
권장 대응
서버 로그·스택 트레이스로 원인을 추적하세요. 사용자에게는 내부 세부 정보를 노출하지 마세요.
502
Bad Gateway
게이트웨이·프록시 역할의 서버가 상위(원본) 서버로부터 잘못된 응답을 받았습니다.
전형적 원인
리버스 프록시(nginx 등) 뒤의 애플리케이션 서버가 죽었거나 잘못된 응답을 보낼 때 발생합니다.
권장 대응
업스트림 서버 상태·로그를 확인하고, 프록시-백엔드 간 연결 설정을 점검하세요.
503
Service Unavailable
서버가 일시적으로 요청을 처리할 수 없습니다(과부하·점검 등).
전형적 원인
트래픽 폭주, 배포·점검 중, 서버 다운타임에서 발생합니다.
권장 대응
Retry-After 헤더로 재시도 시점을 안내하고, 오토스케일·점검 페이지를 준비하세요.
관련 헤더:
HTTP 상태 코드란?
HTTP 상태 코드(Status Code)는 웹 서버가 클라이언트의 요청 처리 결과를 세 자리 숫자로 알려주는 표준 응답 신호입니다. 첫 자리로 다섯 계층으로 나뉩니다.
- 1xx 정보 응답 — 요청을 받아 처리 중(진행 상태)
- 2xx 성공 — 요청이 정상적으로 처리됨(예: 200 OK)
- 3xx 리다이렉트 — 요청 완료를 위해 추가 이동이 필요함(예: 301)
- 4xx 클라이언트 오류 — 요청 자체에 문제가 있음(예: 404, 401)
- 5xx 서버 오류 — 서버가 유효한 요청을 처리하지 못함(예: 500, 502)
REST API 설계에서는 성공·실패를 상태 코드로 명확히 표현하는 것이 관례이며, 301·410 같은 코드는 SEO(검색엔진 최적화)에도 직접 영향을 줍니다. 헷갈리는 유사 코드(301/302/307/308, 401/403, 500/502/503/504)는 각 카드의 “비슷한 코드 비교”로 차이를 확인하세요.
광고
관련 계산기
* 데이터는 RFC 9110·IANA·MDN을 기준으로 정리한 참고 자료입니다. 벤더/비표준 코드는 해당 환경(nginx·Cloudflare 등)에서만 유효합니다.
이 계산기는 무엇인가요
HTTP 상태 코드 참조는 200, 301, 404, 500 같은 HTTP 응답 코드의 의미와 원인, 대응 방법을 빠르게 찾아볼 수 있는 도구입니다. 코드 번호는 물론 영문 명칭이나 한국어 키워드로도 검색할 수 있습니다.
웹 개발 중 에러 원인을 파악해야 하는 개발자, API 응답을 디버깅하는 백엔드 엔지니어, 사이트 리다이렉트를 점검하는 SEO 담당자에게 유용합니다. 실제 서버로 요청을 보내지 않고 표준 데이터를 브라우저에서 조회하는 방식입니다.
사용 방법
검색창에 404, not found, 권한 같은 키워드를 입력하면 해당하는 상태 코드 목록이 즉시 필터링됩니다. 코드를 선택하면 표준 명칭, 카테고리, 의미, 전형적인 발생 원인, 권장 대응이 담긴 상세 카드가 열립니다.
카드에서 코드 번호, 명칭, 의미를 원클릭으로 복사할 수 있어 이슈 리포트나 문서 작성에 바로 붙여넣기 좋습니다.
헷갈리는 코드 비교
실무에서 자주 혼동되는 유사 코드를 나란히 비교할 수 있습니다. 예를 들어 리다이렉트 계열인 301, 302, 307, 308의 영구·임시 여부와 메서드 유지 차이, 인증 문제인 401과 권한 문제인 403의 차이, 서버 오류 계열인 500, 502, 503, 504의 원인 구분을 한 화면에서 확인할 수 있습니다.
수록된 설명은 RFC 9110, IANA 레지스트리, MDN 문서를 기준으로 정리한 표준 데이터입니다.
자주 묻는 질문
- 401과 403의 차이는 무엇인가요?
- 401은 인증 자체가 없거나 잘못된 경우(로그인 필요), 403은 인증은 되었지만 해당 리소스에 접근할 권한이 없는 경우입니다. 로그인 유도가 필요하면 401, 권한 거부면 403이 적절합니다.
- 301과 302 리다이렉트는 어떻게 다른가요?
- 301은 영구 이동으로 검색엔진이 새 주소로 색인을 옮기고, 302는 임시 이동으로 기존 주소의 색인이 유지됩니다. 사이트 주소를 완전히 바꿀 때는 301을 사용하는 것이 일반적입니다.
- 502 Bad Gateway는 왜 발생하나요?
- 프록시나 로드밸런서가 뒤에 있는 서버로부터 잘못된 응답을 받았을 때 발생합니다. 백엔드 서버 다운, 재시작 중, 게이트웨이 설정 오류가 흔한 원인입니다.
- 이 도구가 실제 사이트의 상태를 검사하나요?
- 아니요. 특정 URL로 요청을 보내 상태를 확인하는 도구가 아니라, 상태 코드의 의미와 대응을 조회하는 참조 사전입니다.