504错误本质是Nginx主动放弃等待，需先直连后端验证真实响应耗时，再结合access log中$upstream_response_time字段判断延迟来源；随后在location块内调大proxy_read_timeout等参数，并同步调整FastCGI及PHP超时设置，最后优化后端性能。
504 错误本质是 Nginx 主动放弃等待——不是后端挂了，而是它“等不及了”。关键要判断：是后端真慢，还是 Nginx 设的等待时间太短？两者常并存，需同步处理。
先确认后端真实响应耗时
绕过 Nginx 直连后端，才能排除代理干扰。比如后端跑在 127.0.0.1:8000，就在服务器上执行：
- curl -w "\n%{time_total}\n" -o /dev/null -s http://127.0.0.1:8000/api/v1/data
- 看终端输出的秒数：若稳定在 3–5 秒，说明后端正常，问题在 Nginx 超时设太紧；若动辄 90 秒以上，就得查后端日志、慢 SQL 或阻塞逻辑
- 再查 Nginx access log 中 $upstream_response_time 字段，例如 "0.003 89.215" 表示某次请求后端花了近 90 秒，坐实后端延迟
调整 Nginx proxy 超时参数（必须加在 location 块内）
默认 60 秒对报表导出、AI 接口、复杂查询明显不够。按实际测得的后端最大合理耗时，留出余量设置：
- proxy_connect_timeout 30s —— 连后端服务的建连上限，一般不用调太大，除非网络抖动严重
- proxy_send_timeout 120s —— 向后端发完整请求（含大 body）的总时限
- proxy_read_timeout 300s —— 等待后端响应头和响应体的空闲等待上限，这是最常需调大的项
注意：这些参数不能只写在 http 块里，必须放在 server 或具体 location ~ /api/ 块中才对目标接口生效。
如果是 PHP 后端，还要同步调 FastCGI 超时
Nginx 和 PHP-FPM 各有一套超时机制，任一环节卡住都会导致 504：
- 在站点配置文件的 location ~ \.php$ 块里加：
fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300; - 进宝塔【PHP 设置】→ 【配置修改】，改 php.ini：
max_execution_time = 300
max_input_time = 300
request_terminate_timeout = 300 - 改完务必重载 PHP-FPM 和 Nginx，否则不生效
别只靠拉长超时，顺手压一压后端负载
超时调到 5 分钟只是掩耳盗铃。如果后端本身 CPU 持续 95%、MySQL 慢查频发，问题只会恶化：
- 用 top 或宝塔【终端】看实时资源占用
- 查 MySQL 慢日志：sudo tail -50 /www/server/mysql/data/*.slow.log
- 高频读接口考虑加 Redis 缓存，宝塔软件商店一键安装启用即可
- 导出类接口改成分页或异步任务，避免单次请求扛全量数据
