Nginx 报 504 Gateway Timeout·上游到底卡在哪一步

location /export {
  proxy_connect_timeout 10s;
  proxy_send_timeout 300s;
  proxy_read_timeout 300s;
  proxy_pass http://backend;
}

导出报表时页面等一分钟左右返回 504，后端日志显示任务其实还在执行。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。

追下去是这么回事：网关等待上游响应超过设定时间，主动断开连接，而上游仍在处理。

「Nginx 504 超时」排查到最后往往是很小的一处差异，前面那些复杂猜测可以先放一放。监控和日志的时间要对上，时区不一致会多绕很大一圈。

临时改动用注释写上日期和原因，过两周自己都记不清为什么这么写。动手前把原文件复制一份带时间戳，出问题立刻换回去，比现场分析快得多。

一次只改一处，改完立刻验证，几个改动叠在一起，出问题就说不清是谁导致的。先做最小复现，能稳定跑出来的问题，排查成本会低一个数量级。

处理上按这个顺序：定位是应用慢还是网关超时短；调大代理读取超时；长任务改为异步并轮询结果。

确认没问题再收工，导出请求能等到结果返回，页面不再出现 504。