现象
同步接口执行到 60 秒左右被切断,Nginx 返回 504 Gateway Timeout。FPM 日志里写着 WARNING: [pool www] child 4321, script '/app/SYNc.php' execution timed out (60.5 sec), terminating。业务日志显示数据只写了一半,重试还会产生重复记录。
原因
request_terminate_timeout 是 FPM 层面的硬超时,优先级高于脚本里的 set_time_limit。它到点后直接给子进程发信号,脚本没有机会做收尾。Nginx 的 fastcgi_read_timeout 默认也是 60 秒,两层任意一个先到,连接就断。写一半的数据不是超时本身造成的,而是缺少事务或幂等设计。
解决步骤
第一步,确认两层的实际值。查看 pool 配置和站点配置,找出是谁设了 60 秒,注意别只改 php.ini。
grep -R "request_terminate_timeout" /etc/php/8.3/fpm/
grep -R "fastcgi_read_timeout" /etc/nginx/
第二步,按任务时长放宽并留余量。FPM 的超时略小于网关,网关再留十秒,避免后端已经结束而网关提前断开;同时打开 slowlog,记录真正耗时的位置。
request_terminate_timeout = 120s
fastcgi_read_timeout 130s;
request_slowlog_timeout = 10s
slowlog = /var/log/php-fpm/slow.log
systemctl reload php8.3-fpm
第三步,把长任务改成异步。接口只负责入库和投递队列,返回任务编号,由常驻进程消费。写库使用事务,重复提交按业务唯一键做幂等,避免超时后重试产生脏数据。
验证
接口在 90 秒内正常返回,FPM 日志不再出现 execution timed out;slowlog 能定位到具体函数,重复提交同一条数据不会产生两条记录。
小结
504 要看 FPM 和网关两层超时,改完还要补事务和幂等。真正超过一分钟的任务,交给队列比调超时更合适。
