含义
网关或代理没有及时从上游服务器收到响应。
常见原因
- 数据库查询或外部 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 在等待太久后返回的。