상황별로 정리한 HTTP 상태 코드 표

 

✅ 1xx: 정보 응답 (Informational)

 

상황	상태코드	의미
요청을 받았고 처리 중임	100	Continue
전환 프로토콜 제안 (업그레이드)	101	Switching Protocols

---

🟢 2xx: 성공 응답 (Success)

 

상황	상태코드	의미
요청 성공, 리소스 있음	200	OK
새 리소스 생성됨 (POST/PUT)	201	Created
요청은 성공했으나 응답 본문 없음	204	No Content
클라이언트가 보낸 헤더 조건 충족	206	Partial Content (Range 요청에 사용)

---

🟡 3xx: 리디렉션 (Redirection)

상황 상태코드 의미

		의미
리소스가 임시로 다른 URI에 있음	302	Found (Temporary Redirect)
리소스가 영구적으로 이동됨	301	Moved Permanently
캐시된 콘텐츠 사용 가능	304	Not Modified

---

🔴 4xx: 클라이언트 오류 (Client Error)

상황 상태코드 의미

		의미
잘못된 요청 (문법 오류, 파라미터 오류 등)	400	Bad Request
인증이 필요함	401	Unauthorized
권한이 없거나 접근 금지됨	403	Forbidden
요청한 리소스를 찾을 수 없음	404	Not Found
허용되지 않은 메서드 사용	405	Method Not Allowed
요청 본문이 너무 큼	413	Payload Too Large
URI가 너무 김	414	URI Too Long
미디어 타입을 처리할 수 없음	415	Unsupported Media Type
클라이언트 요청이 너무 많음 (Rate Limiting)	429	Too Many Requests

---

🔥 5xx: 서버 오류 (Server Error)

상황 상태코드 의미

		의미
서버 내부 오류 (예외 발생 등)	500	Internal Server Error
구현되지 않은 기능 요청	501	Not Implemented
백엔드 서버와 통신 불가	502	Bad Gateway
게이트웨이 시간 초과	504	Gateway Timeout
서비스 일시 중지 또는 유지보수 중	503	Service Unavailable

---

📌 상황별 추천 사용 예시

 

상황	추천  상태코드
로그인 실패 (아이디/비번 틀림)	401
로그인 했지만 접근 권한 없음	403
데이터 저장 성공 (POST)	201
데이터 수정 성공 (PUT/PATCH)	200 또는 204
삭제 성공 (DELETE)	204
잘못된 입력값 (필드 누락 등)	400
요청한 리소스 없음 (ID 잘못됨 등)	404
서버 처리 중 에러 발생	500
너무 많은 요청 (API 제한 초과)	429

 

---

✅ [요청 처리 성공]

 

상황	상태코드	설명
일반적인 처리 성공	200 OK	가장 흔한 성공 응답
리소스 생성 (POST 등)	201 Created	새 리소스가 생성됨
처리 성공, 응답 본문 없음	204 No Content	DELETE 등에서 자주 사용
범위 요청 응답 (파일 일부)	206 Partial Content	Range 요청 처리 시 사용

---

🔐 [인증 및 권한 오류]

 

상황	상태코드	설명
인증 실패 (로그인 필요)	401 Unauthorized	토큰 없음, 만료 등
권한 없음 (인증은 됐지만 거부됨)	403 Forbidden	접근 권한 없음

---

❌ [클라이언트 요청 오류]

 

상황	상태코드	설명
요청 자체에 문제가 있음	400 Bad Request	유효성 실패, JSON 파싱 오류 등
요청 리소스 없음	404 Not Found	ID 잘못됨, URL 오타 등
지원하지 않는 HTTP 메서드	405 Method Not Allowed	GET 대신 POST 요청 등
콘텐츠 타입 미지원	415 Unsupported Media Type	예: XML 보낼 때 JSON만 지원 시
요청이 너무 큼	413 Payload Too Large	파일 업로드 초과 등
너무 많은 요청 (속도 제한)	429 Too Many Requests	Rate Limit 초과

---

🔁 [리다이렉션 관련]

 

상황	상태코드	설명
리소스가 새 위치로 이동	301 Moved Permanently	영구 이동
임시 이동 (로그인 후 리다이렉트 등)	302 Found	일시적 이동
클라이언트 캐시 활용 가능	304 Not Modified	조건부 요청 시 사용

---

🔥 [서버 오류]

 

상황	상태코드	설명
서버 내부 처리 오류	500 Internal Server Error	예상치 못한 서버 오류
구현되지 않은 기능 요청	501 Not Implemented	미지원 기능 호출
게이트웨이 또는 프록시 오류	502 Bad Gateway	백엔드 서버로부터 잘못된 응답 수신
서버가 과부하 또는 점검 중	503 Service Unavailable	일시적 장애 또는 유지보수 중
백엔드 응답 시간 초과	504 Gateway Timeout	프록시, 로드밸런서에서 발생 가능

---

📦 [RESTful API 기준 추천 매핑 요약]

 

동작	상태코드	설명
GET	200 / 404	정상 또는 미존재
POST	201 / 400	생성 또는 입력 오류
PUT/PATCH	200 / 204 / 400	수정 완료 또는 오류
DELETE	204 / 404	삭제 완료 또는 미존재
인증요구	401 / 403	로그인 필요 또는 접근 불가
서버문제	500~504	예외, 과부하, 연결 실패 등