Web
HTTP Status 상태 코드(4xx, 5xx) 에 대해 알아보자!
hoonylab
2025. 4. 18. 16:49
728x90
반응형
HTTP 상태 코드 4xx와 5xx 상세 정리
웹 개발이나 API 통신에서 자주 마주치는 HTTP 상태 코드는 응답의 상태를 알려주는 중요한 지표입니다.
특히 4xx(클라이언트 오류)와 5xx(서버 오류)는 문제 원인을 파악하고 디버깅할 때 큰 도움이 됩니다.
📌 400번대: 클라이언트 오류 (Client Error)
클라이언트의 잘못된 요청으로 인해 서버가 요청을 처리할 수 없을 때 사용됩니다.
상태 코드 | 메시지 | 설명 |
---|---|---|
400 | Bad Request | 요청 구문이 잘못되었거나 필수 매개변수가 누락된 경우. |
401 | Unauthorized | 인증이 필요하거나 인증 자격 증명이 올바르지 않은 경우. |
402 | Payment Required | 현재는 거의 사용되지 않지만, 결제가 필요할 때 사용될 수 있습니다. |
403 | Forbidden | 접근 권한이 없어서 서버가 요청을 거부하는 경우. |
404 | Not Found | 요청한 리소스가 서버에 존재하지 않음. |
405 | Method Not Allowed | 요청에 사용된 HTTP 메서드(GET, POST 등)가 허용되지 않음. |
406 | Not Acceptable | 클라이언트가 요청한 형식으로 응답할 수 없음. |
407 | Proxy Authentication Required | 프록시 서버를 통해 인증이 필요함. |
408 | Request Timeout | 클라이언트가 일정 시간 내에 요청을 완료하지 못함. |
409 | Conflict | 요청이 서버의 현재 상태와 충돌함. 주로 리소스 수정 시. |
410 | Gone | 요청한 리소스가 더 이상 존재하지 않으며, 앞으로도 사용 불가. |
429 | Too Many Requests | 클라이언트가 너무 많은 요청을 보내 서버가 제한을 둔 경우. |
📌 500번대: 서버 오류 (Server Error)
클라이언트의 요청은 유효하지만, 서버 내부 문제로 인해 요청을 처리하지 못했을 때 발생합니다.
상태 코드 | 메시지 | 설명 |
---|---|---|
500 | Internal Server Error | 서버 내부 오류. 원인을 특정하기 어려운 일반적인 서버 에러. |
501 | Not Implemented | 서버가 요청 메서드를 인식하지 못했거나, 구현되지 않은 기능. |
502 | Bad Gateway | 게이트웨이 또는 프록시 서버가 잘못된 응답을 받았을 때. |
503 | Service Unavailable | 서버가 과부하 상태이거나 유지보수 중으로 응답 불가. |
504 | Gateway Timeout | 게이트웨이 또는 프록시 서버가 응답을 기다리다 시간 초과됨. |
505 | HTTP Version Not Supported | 서버가 지원하지 않는 HTTP 버전으로 요청됨. |
507 | Insufficient Storage | 서버가 요청을 저장하기에 충분한 공간이 없음 (WebDAV 관련). |
508 | Loop Detected | 무한 루프가 탐지됨 (WebDAV 사용 시). |
✅ 요약
- 4xx: 클라이언트의 요청에 문제가 있음 (예: 잘못된 요청, 인증 실패 등)
- 5xx: 서버 자체에 문제가 있어 요청 처리 불가 (예: 서버 다운, 게이트웨이 오류 등)
728x90
반응형