意義
閘道或代理沒有及時從上游伺服器收到回應。
常見原因
- 資料庫查詢或外部 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 在等待太久後回傳的。