PHP 脚本 max_execution_time 设 300 仍报 504 网关超时怎么对齐

现象

数据导出接口本地跑 90 秒能完成,线上浏览器却返回 504 Gateway Timeout。脚本开头已经写了 set_time_limit(0),PHP 日志显示任务最后执行完毕,但用户始终拿不到结果。Nginx 的 error_log 里是 upstream timed out while reading response header。

原因

504 是网关等不到上游响应产生的,不由 PHP 的 max_exeCution_time 单独决定。FPM 还有 request_termiNATe_timeout,Nginx 有 fastcgi_read_timeout 和 proxy_read_timeout,默认都是 60 秒。set_time_limit 只影响 PHP 自身执行时间,管不到这两层;任一层先到点,连接就被切断。

解决步骤

第一步,确认各层当前值。查 FPM pool 和 Nginx 站点配置,把三个超时都找出来,避免只改一处。

grep -r "request_terminate_timeout" /etc/php/8.3/fpm/
grep -r "fastcgi_read_timeout\|proxy_read_timeout" /etc/nginx/

第二步,按最长任务统一调大。让 max_execution_time、request_terminate_timeout 和 fastcgi_read_timeout 保持同一量级,且网关略大于后端,给收尾留出余量。

max_execution_time = 300
request_terminate_timeout = 300s
fastcgi_read_timeout 330s;
proxy_read_timeout 330s;
request_slowlog_timeout = 10s

第三步,把长任务移出请求。导出、批量同步改成队列任务,接口只返回任务编号,前端轮询进度。这样既不受网关超时限制,也不会长期占用 FPM 进程。

验证

接口在 100 秒左右正常返回 200,Nginx error_log 不再出现 upstream timed out;slowlog 里能看到耗时点,但没有进程被强制终止的记录。

小结

504 要对齐四层超时,而不是只改 set_time_limit。超过一分钟的任务,优先改成异步队列更稳。

您可以还会对下面的文章感兴趣: