정의
클라이언트 오류를 나타내는 상태 코드
4xx 상태 코드는 클라이언트의 잘못된 요청으로 인해 서버가 요청을 처리하지 못했음을 의미합니다.
주로 잘못된 URL, 인증 실패, 권한 부족, 잘못된 요청 형식 등에서 발생합니다.
주로 잘못된 URL, 인증 실패, 권한 부족, 잘못된 요청 형식 등에서 발생합니다.
왜 알아야 할까?
사용자 요청 오류를 진단하고 안내하는 데 필수
요청 오류는 사용자 경험에 큰 영향을 미칩니다.
적절한 4xx 응답 코드를 통해 클라이언트는 문제를 명확히 인지하고 수정할 수 있습니다.
적절한 4xx 응답 코드를 통해 클라이언트는 문제를 명확히 인지하고 수정할 수 있습니다.
전체 목록
HTTP 표준에 정의된 주요 4xx 응답 코드입니다.
| 상태 코드 | 상태 이름 | 설명 |
|---|---|---|
| 400 | Bad Request | 서버가 요청 구문을 이해하지 못했습니다. 요청 형식 오류일 수 있습니다. |
| 401 | Unauthorized | 인증이 필요하거나 실패한 경우 발생합니다. 토큰 누락/만료 등 |
| 403 | Forbidden | 클라이언트는 인증되었지만 해당 리소스에 접근 권한이 없습니다. |
| 404 | Not Found | 요청한 리소스를 찾을 수 없습니다. URL 경로 오류 등 |
| 405 | Method Not Allowed | 요청한 메서드는 해당 리소스에서 허용되지 않습니다 (예: GET만 가능). |
| 408 | Request Timeout | 클라이언트가 서버로부터 응답을 기다리는 중에 타임아웃 발생 |
| 409 | Conflict | 리소스 상태가 충돌하여 요청을 처리할 수 없습니다 (중복된 데이터 등) |
| 410 | Gone | 요청한 리소스가 영구적으로 삭제되었음을 나타냅니다. |
| 413 | Payload Too Large | 요청 본문 크기가 서버에서 허용하는 한도를 초과했습니다. |
| 429 | Too Many Requests | 짧은 시간 동안 너무 많은 요청을 보낸 경우 |
사용 예시
클라이언트 오류는 피드백과 디버깅에 핵심입니다.
💡 400: 클라이언트가 잘못된 JSON 형식이나 필수 값 누락
💡 401: 로그인 토큰 누락, 만료, 잘못된 서명 등
💡 403: 로그인은 했지만 권한이 없는 사용자 접근 시
💡 404: 존재하지 않는 게시글, API 경로 오타 등
💡 409: 동일한 리소스를 중복해서 생성 요청할 때
💡 429: 디도스 방어, API 사용량 제한 등
728x90