배포 후 502 Bad Gateway 또는 504 Gateway Timeout이 보여요

배포 직후 프록시·로드 밸런서와 원본 서버 사이에서 502·504가 발생할 때 응답 구간을 나눠 확인하는 시작 Guide입니다. 오류 원문과 발생 환경이 일치하지 않으면 원인을 단정하지 않습니다.

먼저 기록할 것

1. 화면·브라우저 개발자 도구·서버 로그 중 어디에서 오류를 확인했는지 기록합니다.
2. 오류 문구·상태 코드·요청 주소·발생 시각을 가능한 한 원문 그대로 보존합니다.
3. 최근 배포·설정·도메인·플러그인·호스팅 변경 여부를 기록합니다.
4. 문의 자료에서는 비밀번호·토큰·쿠키·고객 정보·결제 정보를 제거합니다.

상황별 다음 단계

1. HTTP 502: Bad gateway이면 HTTP 502: Bad gateway 문서를 확인합니다.
2. HTTP 504: Gateway timeout이면 HTTP 504: Gateway timeout 문서를 확인합니다.

확인 순서

1. 문제를 재현하는 URL 또는 기능을 한 가지로 고정합니다.
2. 위 Problem의 관찰값과 현재 화면·로그가 일치하는지 비교합니다.
3. 한 번에 하나의 설정이나 코드만 확인하고, 변경 전 값을 보관합니다.
4. 수정 후 같은 브라우저·주소·기능에서 다시 확인합니다.

502와 504를 구분하는 기준

관찰값	판정 기준	다음 확인
502가 즉시 반환됨	프록시가 원본의 유효하지 않은 응답·연결 실패를 받은 상태일 수 있습니다.	원본 포트, 프로세스 상태, 프록시와 원본의 프로토콜을 비교합니다.
504가 일정 시간 뒤 반환됨	중간 서버의 시간 제한 안에 원본 응답이 도착하지 않은 상태일 수 있습니다.	원본 처리 시간, 헬스 체크, 각 구간의 timeout을 기록합니다.
배포 직후에만 재현됨	새 프로세스·환경 변수·라우팅 설정이 적용된 구간을 확인해야 합니다.	배포 시각과 프록시·원본 로그의 요청 ID를 비교합니다.

오류 코드를 없애기 위해 timeout을 먼저 늘리거나 프록시·방화벽 제한을 모두 해제하지 않습니다. 원본 로그에서 같은 요청이 처리됐는지 확인한 뒤 해당 구간만 변경합니다.

수정 후 재확인

1. 동일 URL을 프록시 주소와 원본 확인 경로에서 각각 요청해 응답 코드와 시간을 기록합니다.
2. 배포·프로세스 재시작 뒤 원본 헬스 체크와 애플리케이션 로그를 확인합니다.
3. 정상·느린 요청을 각각 반복해 502와 504가 다시 발생하는 조건을 비교합니다.
4. 프록시·원본·애플리케이션의 요청 ID와 시각이 일치할 때만 해결로 기록합니다.

관련 점검표: 서버 오류 원인 구간 확인

오진하지 않기

이 Guide의 제목이나 플랫폼 이름만으로 원인을 확정하지 않습니다. Problem 문서의 조건과 실제 관찰값이 다르면 설정을 변경하지 말고 오류 원문과 환경을 다시 기록합니다.