502 Bad Gateway 체크리스트

Problem

사이트 접속 시 최종 응답 코드가 502 Bad Gateway로 반환됩니다.

Symptoms

• HTTP Check에서 최종 코드가 502입니다.
• reverse proxy 또는 CDN 앞단에서는 열려 있지만 실제 서비스 응답이 비정상입니다.
• 간헐적으로만 502가 발생하거나 특정 경로에서 더 자주 발생합니다.

Top 3 Causes

1. upstream 서비스 비정상 - origin 애플리케이션이 죽었거나 정상 응답을 주지 못합니다.
2. proxy -> upstream 연결 실패 - 내부 포트, 소켓, health check, 연결 경로가 맞지 않습니다.
3. DNS 또는 대상 분기 오류 - 프록시가 잘못된 upstream 또는 이전 환경을 가리킵니다.

Diagnose with DechoNet

• HTTP Check로 최종 코드와 응답 흐름을 확인합니다.
• Port Check로 예상 upstream 포트가 열려 있는지 확인합니다.
• DNS Lookup으로 도메인이 의도한 origin 또는 프록시 대상으로 향하는지 검증합니다.

Resolution Checklist

• upstream 애플리케이션이 정상 기동 중인지 확인합니다.
• reverse proxy 설정의 upstream 주소, 포트, health check 경로를 검토합니다.
• origin 포트가 실제로 열려 있고 내부 네트워크에서 도달 가능한지 확인합니다.
• 프록시가 이전 배포 환경이나 잘못된 호스트를 가리키지 않는지 점검합니다.
• 수정 후 HTTP Check를 다시 실행해 502가 사라졌는지 확인합니다.

When to Escalate

• managed load balancer 또는 플랫폼 ingress가 개입된 경우 인프라 담당자 확인이 필요합니다.
• 간헐적 502가 지속되면 autoscaling, upstream saturation, keepalive 설정까지 봐야 합니다.