Nginx+PHP-FPM环境下请求返回499状态码的排查咨询

阿华AIGC实验室

2026-4-23

遇到这种499状态码的问题，首先得明确它的核心含义：Nginx的499状态码表示客户端在服务器返回响应前主动断开了连接，不是Nginx或PHP-FPM服务端主动终止请求导致的。结合你用curl调用40分钟长脚本的场景，我给你梳理几个排查方向：

检查curl客户端的超时设置：
curl本身有超时控制逻辑，如果你没有显式设置足够长的总超时时间，curl可能会在运行一段时间后主动断开连接。建议在curl命令中加上-m 28800（设置总超时为8小时，远大于你的脚本运行时间），同时加上-N参数禁用输出缓冲，确保连接能持续到脚本完成。比如：
```
curl -m 28800 -N http://your-domain/script.php
```
解决长连接的空闲断开问题：
如果你的脚本长时间没有输出内容，中间的网络设备（比如防火墙、路由器）可能会把这个“空闲”的TCP连接断开，进而导致curl主动终止请求。你可以在PHP脚本中定期输出一些无意义的内容（比如空格）并刷新缓冲，保持连接有数据流动：
```
// 每隔5分钟输出一个空格并刷新缓冲
if (time() % 300 === 0) {
    echo ' ';
    ob_flush();
    flush();
}
```
确认Nginx的其他超时配置：
除了你已经设置的fastcgi_read_timeout = 2h;，还可以检查这几个参数是否设置合理：
- client_header_timeout：确保大于请求建立的时间（比如设为60s即可，一般不会影响长运行请求）
- client_body_timeout：同样设为足够长的时间，比如60s
  另外可以开启Nginx的TCP优化参数：
```
tcp_nopush on;
tcp_nodelay on;
```
检查PHP-FPM的相关超时设置：
虽然你已经设置了max_execution_time = 9000，但还要确认PHP-FPM配置中的request_terminate_timeout参数——这个是FPM进程处理单个请求的最大时间，默认是0（不限制），如果被设置了较短的值，可能会导致进程被终止。建议将它设为远大于脚本运行时间的值，比如36000（10小时）。
排查服务器TCP层面的超时：
Linux系统的TCP keepalive参数可能会影响长连接的存活时间，你可以检查以下几个系统参数：
- /proc/sys/net/ipv4/tcp_keepalive_time：默认一般是7200秒（2小时），如果你的脚本运行时间接近这个值，可能会被系统断开连接，可以调大到14400（4小时）
- /proc/sys/net/ipv4/tcp_keepalive_intvl和/proc/sys/net/ipv4/tcp_keepalive_probes：可以保持默认，或者根据需要调整，确保系统不会过早探测断开连接。