502 Bad Gateway와 504 Gateway Timeout 원인과 확인 순서

“502 오류”, “504 오류”, “502 bad gateway 해결”처럼 검색하는 상황에서 사용합니다. 두 상태는 모두 중간 서버가 관련될 수 있지만, 502는 업스트림 응답을 정상적인 게이트웨이 응답으로 처리하지 못한 상태이고 504는 정해진 시간 안에 응답을 받지 못한 상태로 구분해 확인합니다. 오류 코드만으로 PHP·WordPress·카페24·Cloudflare 중 하나를 원인으로 단정하지 않습니다.

먼저 기록할 것

1. 오류 화면 또는 실제 HTTP 응답의 상태 코드·전체 문구·발생 시각을 기록합니다.
2. 오류가 난 전체 URL, HTTP 메서드, 응답 헤더의 server·via·요청 식별자를 기록합니다.
3. Cloudflare·CDN·로드 밸런서 등 중간 서버를 거쳤는지와 원본 주소를 확인합니다.
4. 최근 배포, 프록시 경로, 업스트림 포트, 시간 제한 변경을 변경 시각과 함께 기록합니다.

관찰값별 판정

관찰값	우선 확인할 구간	다음 문서
502가 요청 직후 반복됨	중간 서버와 원본의 연결·포트·프로토콜, 원본 프로세스 로그	502 Bad Gateway
504가 일정 시간 지연 뒤 반복됨	원본 처리 시간, 헬스 체크, 프록시·로드 밸런서 시간 제한	504 Gateway Timeout
오류 화면과 실제 응답 상태가 다름	브라우저 화면, CDN 응답, 원본 응답을 각각 비교	화면 문구와 실제 상태 불일치
배포 직후에만 재현됨	배포 산출물, 환경 변수, 라우팅, 프로세스 시작 로그	배포 후 API 요청 실패

502가 보인다는 사실만으로 원본 애플리케이션이 중지됐다고 판단하지 않습니다. 504가 보인다는 사실만으로 시간 제한을 늘리지도 않습니다. 중간 서버 로그와 원본 로그에서 같은 요청 시각을 찾아야 합니다.

안전한 확인 순서

1. 먼저 설정을 변경하지 않고 브라우저 Network 정보와 오류 화면을 저장합니다.
2. 같은 URL에 대해 허용된 점검 환경에서 응답 상태와 이동 경로를 비교합니다.
3. 원본 서버의 프로세스·포트·처리 로그와 프록시의 요청 로그를 같은 시각으로 대조합니다.
4. 원인이 확인된 한 항목만 변경하고, 변경 전 값을 보관합니다.

수정 후 재확인

같은 URL을 최초에 실패한 브라우저와 다른 네트워크에서 반복 요청합니다. 정상 화면뿐 아니라 상태 코드, 응답 시간, 이동 경로, 중간 서버·원본 로그가 같은 요청을 정상 처리했는지 함께 확인합니다. 재현이 멈췄다는 결과만 기록하지 말고 확인한 시간과 요청 조건을 남기세요. 서버 오류 원인 구간 확인표도 함께 사용합니다.