정의
서버 오류를 나타내는 상태 코드
5xx 상태 코드는 서버가 요청을 처리하는 도중 오류가 발생했음을 의미합니다.
클라이언트의 요청에는 문제가 없지만, 서버 측에서 오류가 발생했을 때 사용됩니다.
클라이언트의 요청에는 문제가 없지만, 서버 측에서 오류가 발생했을 때 사용됩니다.
왜 알아야 할까?
서버 장애의 신호, 운영·디버깅의 핵심 포인트
서버의 안정성과 장애 분석에 중요한 단서가 됩니다.
배포 후 모니터링, 로깅 시스템에서 빠르게 파악해야 하는 코드들입니다.
배포 후 모니터링, 로깅 시스템에서 빠르게 파악해야 하는 코드들입니다.
전체 목록
HTTP 표준에 정의된 모든 5xx 응답 코드입니다.
| 상태 코드 | 상태 이름 | 설명 |
|---|---|---|
| 500 | Internal Server Error | 서버 내부에서 알 수 없는 오류가 발생했습니다. |
| 501 | Not Implemented | 서버가 요청을 수행하는 기능을 지원하지 않습니다. |
| 502 | Bad Gateway | 게이트웨이나 프록시 서버가 받은 응답이 잘못되었습니다. |
| 503 | Service Unavailable | 서버가 과부하 또는 점검 등으로 일시적으로 요청을 처리할 수 없습니다. |
| 504 | Gateway Timeout | 게이트웨이 또는 프록시 서버가 응답을 기다리다가 타임아웃되었습니다. |
| 505 | HTTP Version Not Supported | 서버가 요청에 사용된 HTTP 버전을 지원하지 않습니다. |
| 506 | Variant Also Negotiates | 투명한 콘텐츠 협상이 순환 참조로 인해 실패했습니다. |
| 507 | Insufficient Storage | 서버가 요청을 저장하기에 충분한 공간이 없습니다 (WebDAV). |
| 508 | Loop Detected | 서버가 무한 루프를 감지했습니다 (WebDAV). |
| 510 | Not Extended | 요청에 필요한 추가 확장이 서버에 제공되지 않았습니다. |
| 511 | Network Authentication Required | 네트워크 인증이 필요합니다 (예: 포털 로그인 페이지). |
사용 예시
장애 대응과 로깅 분석에서 활용됩니다.
💡 500: 예외 처리 실패, NullPointerException 등 발생 시
💡 502: 백엔드 서버의 죽음, nginx로부터의 잘못된 응답 수신 시
💡 503: 서버 점검 모드 진입 또는 과부하 상황에서 자동 반환
💡 504: 외부 API 응답 지연으로 인한 타임아웃 시
💡 511: 공용 와이파이 로그인 화면 접속 전 인증 필요 시
728x90