HTTP 상태 코드 사전

HTTP 상태 코드의 의미를 찾아보세요. 404, 500 등 웹 에러 코드의 원인과 해결 방법을 확인하는 참고 도구입니다

✅ Local Processing📡 HTTP Reference
100Continue
설명:

클라이언트가 요청을 계속 진행할 수 있음

원인:

서버가 요청의 첫 부분을 받았음

해결 방법:

클라이언트는 요청을 계속 전송

101Switching Protocols
설명:

프로토콜 전환 중

원인:

서버가 클라이언트의 프로토콜 전환 요청을 승인

해결 방법:

새 프로토콜로 통신 계속

200OK
설명:

요청 성공

원인:

서버가 요청을 성공적으로 처리

해결 방법:

정상 응답, 추가 조치 불필요

201Created
설명:

리소스 생성 성공

원인:

POST/PUT 요청으로 새 리소스 생성

해결 방법:

Location 헤더로 리소스 위치 확인

204No Content
설명:

성공했지만 응답 본문 없음

원인:

요청 처리 성공, 반환할 데이터 없음

해결 방법:

정상, 추가 조치 불필요

301Moved Permanently
설명:

리소스가 영구적으로 이동

원인:

URL이 영구적으로 변경됨

해결 방법:

Location 헤더의 새 URL로 이동, 북마크 업데이트

302Found
설명:

리소스가 임시로 이동

원인:

URL이 일시적으로 변경됨

해결 방법:

Location 헤더의 URL로 임시 이동

304Not Modified
설명:

캐시된 리소스 사용 가능

원인:

리소스가 수정되지 않음

해결 방법:

캐시된 버전 사용, 재다운로드 불필요

307Temporary Redirect
설명:

임시 리다이렉트 (메서드 유지)

원인:

리소스가 임시로 다른 URI에 위치

해결 방법:

Location 헤더의 URL로 이동, 원래 HTTP 메서드 유지

308Permanent Redirect
설명:

영구 리다이렉트 (메서드 유지)

원인:

리소스가 영구적으로 다른 URI로 이동

해결 방법:

Location 헤더의 URL로 이동, HTTP 메서드 유지

400Bad Request
설명:

잘못된 요청

원인:

요청 구문 오류, 잘못된 파라미터

해결 방법:

요청 형식 확인, API 문서 참고

401Unauthorized
설명:

인증 필요

원인:

인증 정보 없음 또는 유효하지 않음

해결 방법:

올바른 인증 정보(토큰, 비밀번호) 제공

403Forbidden
설명:

접근 거부

원인:

권한 없음, 인증은 되었으나 허가되지 않음

해결 방법:

접근 권한 확인, 관리자에게 권한 요청

404Not Found
설명:

리소스를 찾을 수 없음

원인:

URL 오타, 삭제된 리소스

해결 방법:

URL 확인, 리소스 존재 여부 확인

405Method Not Allowed
설명:

허용되지 않는 HTTP 메서드

원인:

GET 요청만 허용하는데 POST 전송 등

해결 방법:

허용된 HTTP 메서드 확인 (Allow 헤더)

408Request Timeout
설명:

요청 시간 초과

원인:

서버가 요청을 기다리는 동안 시간 초과

해결 방법:

네트워크 상태 확인, 재시도

409Conflict
설명:

리소스 충돌

원인:

중복 데이터, 버전 충돌

해결 방법:

현재 상태 확인 후 재시도

413Payload Too Large
설명:

요청 페이로드가 너무 큼

원인:

업로드 파일 크기 제한 초과

해결 방법:

파일 크기 줄이기, 서버 제한 확인

414URI Too Long
설명:

URL이 너무 김

원인:

GET 요청의 쿼리 파라미터가 너무 많음

해결 방법:

POST로 변경, URL 길이 줄이기

415Unsupported Media Type
설명:

지원하지 않는 미디어 타입

원인:

Content-Type이 잘못됨

해결 방법:

올바른 Content-Type 헤더 설정

429Too Many Requests
설명:

요청 횟수 제한 초과

원인:

Rate Limit 초과

해결 방법:

일정 시간 후 재시도, Retry-After 헤더 확인

500Internal Server Error
설명:

서버 내부 오류

원인:

서버 코드 오류, 예외 발생

해결 방법:

서버 로그 확인, 관리자에게 문의

501Not Implemented
설명:

구현되지 않은 기능

원인:

서버가 요청 메서드를 지원하지 않음

해결 방법:

서버 기능 확인, API 문서 참고

502Bad Gateway
설명:

게이트웨이 오류

원인:

게이트웨이/프록시 서버가 잘못된 응답 받음

해결 방법:

잠시 후 재시도, 서버 상태 확인

503Service Unavailable
설명:

서비스 이용 불가

원인:

서버 과부하, 유지보수 중

해결 방법:

Retry-After 헤더 확인 후 재시도

504Gateway Timeout
설명:

게이트웨이 시간 초과

원인:

업스트림 서버 응답 없음

해결 방법:

재시도, 타임아웃 설정 확인

505HTTP Version Not Supported
설명:

HTTP 버전 미지원

원인:

서버가 요청의 HTTP 버전을 지원하지 않음

해결 방법:

HTTP 버전 확인, 서버 업그레이드

HTTP 상태 코드 참고 자료 및 자주 묻는 질문

HTTP 상태 코드란?

HTTP 상태 코드는 웹 서버가 클라이언트의 요청에 대한 응답 상태를 나타내는 3자리 숫자입니다. 각 코드는 요청이 성공했는지, 실패했는지, 추가 조치가 필요한지 등을 알려줍니다.

상태 코드 카테고리

  • 1xx (정보): 요청을 받았으며 프로세스를 계속 진행
  • 2xx (성공): 요청을 성공적으로 받았으며 인식하고 수용
  • 3xx (리다이렉션): 요청 완료를 위해 추가 작업 조치 필요
  • 4xx (클라이언트 오류): 요청에 오류가 있어 서버가 수행할 수 없음
  • 5xx (서버 오류): 서버가 명백히 유효한 요청을 수행하지 못함

가장 자주 마주치는 오류 코드

  • 404 Not Found: 가장 흔한 오류, 페이지를 찾을 수 없음
  • 500 Internal Server Error: 서버 내부 오류
  • 502 Bad Gateway: 게이트웨이나 프록시 서버가 잘못된 응답을 받음
  • 503 Service Unavailable: 서버가 일시적으로 요청을 처리할 수 없음

4xx vs 5xx 오류의 차이

4xx 오류는 클라이언트 측 문제입니다. 잘못된 URL, 권한 없음, 잘못된 요청 등 클라이언트가 수정해야 할 문제입니다.

5xx 오류는 서버 측 문제입니다. 서버 다운, 코드 오류, 게이트웨이 문제 등 서버 관리자가 해결해야 할 문제입니다.

Rate Limit (429) 오류 해결 방법

429 Too Many Requests는 너무 많은 요청을 보냈을 때 발생합니다.

  • Retry-After 헤더를 확인하여 재시도 시간 확인
  • 요청 빈도를 줄이거나 백오프(backoff) 전략 사용
  • API 제공자의 rate limit 정책 확인

이 도구는 어떻게 사용하나요?

상태 코드 번호나 이름을 검색하거나, 카테고리 버튼을 클릭하여 특정 범위의 코드만 볼 수 있습니다. 각 코드의 설명, 발생 원인, 해결 방법을 확인할 수 있습니다.