首页/网络/协议速查/504 Gateway Timeout 网关超时
HTTP 方法与状态码91 条

504 Gateway Timeout 网关超时

网关/代理等待上游响应超过自身超时时间:上游太慢或卡死,而不是不可达。

协议速查网络更新于 2026-10-12
名称504 Gateway Timeout
作用上游处理超时
规范RFC 9110 §15.6.5
常见配置Nginx proxy_read_timeout;网关 timeout 参数

定位慢在哪一段

定位慢在哪一段
# 结合访问日志的 upstream_response_time 对比请求总耗时
awk '{print $7, $upstream_response_time, $request_time}' /var/log/nginx/access.log | sort -k2 -rn | head
504 排查优先级:上游是否收到请求(截包/日志)→ 处理为何慢(慢 SQL、外部依赖)→ 超时阈值是否合理。调大超时只是止痛,先找到慢的根因。

易错点

  • 网关超时(如 60s)小于上游处理时间(如导出任务 5 分钟),长任务必须异步化(202+轮询)
  • 负载均衡健康检查超时与业务超时混淆,健康检查误摘节点放大故障

数据来源与参考

  • RFC 9110 §15.6.5 504 Gateway Timeout

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌