HTTP 500, 502, 503 오류 문제 해결 방법

5xx 오류는 서버 측 실패를 의미하지만, 각 코드는 서로 다른 실패 계층을 가리킵니다. 이 가이드는 해당 계층을 빠르게 분리하는 데 도움이 됩니다.

빠른 트리아지(처음 5분)

1. URL을 웹사이트 확인 도구 에서 실행해 상태와 응답 시간을 기록하세요.
2. 문제가 하나의 URL 경로에만 영향을 주는지, 모든 엔드포인트에 영향을 주는지 확인하세요.
3. 오류가 지속적인지 간헐적인지 확인하세요.
4. 배포, 구성 변경 또는 트래픽 급증과 연관 지으세요.

500 Internal Server Error

일반적인 앱/서버 오류입니다. 가장 흔한 원인: 처리되지 않은 애플리케이션 예외, 잘못된 환경 변수, 권한 문제, 실패한 종속성 호출.

• 먼저 애플리케이션 로그, 그다음 웹 서버 로그를 검토하세요.
• 최근 릴리스와 마이그레이션을 확인하세요.
• 파일 권한과 런타임 시크릿을 검증하세요.

502 Bad Gateway

보통 Nginx/Apache/로드 밸런서와 업스트림 앱 사이의 프록시/게이트웨이 문제입니다.

• 업스트림 프로세스가 실행 중이고 예상 host/port에서 수신 대기하는지 확인하세요.
• 프록시 타임아웃과 keepalive 불일치를 확인하세요.
• 컨테이너 배포에서 업스트림 DNS를 검증하세요.

503 Service Unavailable

서비스를 일시적으로 사용할 수 없습니다. 과부하, 유지보수 모드, 워커 풀 고갈이 흔한 원인입니다.

• CPU, 메모리, 연결 풀 포화 상태를 점검하세요.
• 오토스케일링 이벤트와 속도 제한을 확인하세요.
• 유지보수 플래그나 잘못 구성된 헬스 체크를 검증하세요.

지원 에스컬레이션 시 포함할 내용

• URL + 정확한 상태 코드
• 최초 관측 시각(UTC 권장)
• 전역 문제인지 특정 지역 문제인지
• 최근 배포 또는 인프라 변경 사항

DNS 측 오류는 DNS 전파 가이드를 참고하세요. 인증서 호스트명 불일치 오류는 이 SSL 가이드를 참고하세요.