의미
게이트웨이나 프록시가 업스트림 서버로부터 제때 응답을 받지 못했습니다.
흔한 원인
- 느린 데이터베이스 쿼리나 외부 API 호출
- 프록시 타임아웃이 처리 시간보다 짧음
- 네트워크 문제로 업스트림 서버에 도달할 수 없음
해결 방법
클라이언트 또는 방문자라면
나중에 재시도하세요. 오래 걸리는 작업이라면 API에 비동기 처리가 있는지 알아보세요.
사이트나 API 운영자라면
느린 경로를 빠르게 하거나 백그라운드 작업으로 옮기고, 프록시 타임아웃(proxy_read_timeout)은 현실적인 값까지만 올리세요.
응답 예시
HTTP/1.1
HTTP/1.1 504 Gateway Timeout
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Length: 0명세
자주 묻는 질문
› nginx의 504 Gateway Timeout을 해결하려면?
업스트림이 느린 이유를 찾으세요. 긴 요청이 예상된다면 proxy_read_timeout과 앱 서버 타임아웃을 함께 올리세요.
› 504는 내 앱이 반환하나요, 프록시가 반환하나요?
앱 앞에 있는 프록시, 로드 밸런서, CDN이 너무 오래 기다린 끝에 반환합니다.