HTTP 504: Gateway timeout

증상

브라우저 또는 HTTP 클라이언트에 504 Gateway Timeout이 표시됩니다. 이 코드는 프록시·게이트웨이·로드 밸런서가 정해진 시간 안에 업스트림 서버 응답을 받지 못한 상태를 뜻합니다.

확인

1. 오류가 난 전체 URL, 발생 시각, 오류까지 걸린 시간을 기록합니다.
2. 프록시 또는 로드 밸런서를 거친 요청과 원본 서버에 직접 도달하는 요청의 결과·처리 시간을 비교합니다.
3. 각 중간 서버와 원본 서버의 같은 시각 로그에서 업스트림 응답 시간과 시간 제한을 확인합니다.

Cloudflare를 쓰는 사이트라면 브랜딩이 있는 표준 504인지, 브랜딩이 없는 빈 오류 화면인지도 함께 확인합니다. 화면 유형에 따라 원본 서버와 Cloudflare 중 확인 대상이 달라집니다.

재확인

시간 제한 또는 업스트림 처리에서 확인한 한 항목만 수정한 뒤 같은 요청을 다시 실행합니다. 504가 사라졌는지와 실제 처리 시간이 달라졌는지 함께 확인합니다.

주의

시간 제한을 늘리는 것만으로 느린 업스트림 처리나 과부하가 해결됐다고 판단하지 마세요. 장애 중에는 시간 제한·포트·방화벽 설정을 동시에 바꾸지 않습니다.

관찰값 기록

문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.

다음 항목을 실제 값과 함께 확인합니다.

1. 오류 화면 또는 HTTP 응답에 504 Gateway Timeout이 표시되는지 확인하고, 전체 URL·발생 시각·오류까지 걸린 시간을 기록합니다.
2. 같은 요청을 프록시 또는 로드 밸런서를 거친 경로와 원본 서버에 직접 도달하는 경로로 나눠 결과와 처리 시간을 비교합니다.
3. 프록시·로드 밸런서·원본 서버의 같은 시각 로그에서 업스트림 응답 시간, 연결 실패, 설정된 시간 제한을 확인합니다.
4. 한 시간 제한 또는 업스트림 처리 문제를 수정했다면 같은 요청을 다시 실행해 504가 사라졌는지와 처리 시간이 변했는지 확인합니다.

판정 기준

오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.

안전한 다음 확인

설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.