根本原因是PHP-FPM处理超时被强制终止，导致Nginx收不到响应而返回502；必须同步调整PHP-FPM的request_terminate_timeout、Nginx的fastcgi_read_timeout（≥前者）、PHP的max_execution_time，并排查脚本阻塞逻辑。
PHP文件执行超时导致Nginx返回502错误，根本原因通常是PHP-FPM处理请求时间超过Nginx或PHP-FPM自身的超时限制。修复需同时调整Nginx、PHP-FPM和PHP脚本三层配置，缺一不可。
1. 调整PHP-FPM全局超时参数（php-fpm.conf 或 www.conf）
PHP-FPM默认request_terminate_timeout和request_slowlog_timeout可能未启用或设得太短（如0或30s），导致worker被强制终止，Nginx收不到响应而报502。
编辑PHP-FPM池配置文件（常见路径：/etc/php/{version}/fpm/pool.d/www.conf），添加或修改以下项：
; 允许单个请求最长执行时间（单位：秒），0 表示不限制（生产环境慎用） request_terminate_timeout = 300 <p>; 记录慢请求日志的阈值（可选，便于排查） request_slowlog_timeout = 60</p><p>; 子进程最大执行时间（与上面配合，防止僵死） pm.max_requests = 500
修改后重启PHP-FPM：
立即学习“PHP免费学习笔记（深入）”；
sudo systemctl restart php{version}-fpm # 如 php8.2-fpm
2. 同步调整Nginx超时设置（server 或 location 块）
Nginx的fastcgi_read_timeout必须 ≥ PHP-FPM的request_terminate_timeout，否则Nginx会在PHP还在处理时主动断连，触发502。
在Nginx站点配置的location ~ \.php$块中加入：
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php{version}-fpm.sock; # 或 127.0.0.1:9000
fastcgi_index index.php;
<pre class="brush:php;toolbar:false;"># 关键超时设置（单位：秒）
fastcgi_connect_timeout 60;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300; # 必须 ≥ PHP-FPM的 request_terminate_timeout
fastcgi_buffer_size 128k;
fastcgi_buffers 4 256k;
fastcgi_busy_buffers_size 256k;}
重载Nginx生效：
sudo nginx -t && sudo systemctl reload nginx
3. 检查并优化PHP脚本自身逻辑
即使配置调高，若脚本存在死循环、阻塞IO（如未设超时的cURL、file_get_contents）、大数组遍历等，仍会超时。建议主动控制：
- 用
set_time_limit(300)动态延长脚本最大执行时间（需未禁用max_execution_time） - cURL请求务必加超时：
curl_setopt($ch, CURLOPT_TIMEOUT, 60); - 数据库查询避免无LIMIT全表扫描，必要时加
ini_set('max_execution_time', '300'); - 大文件处理改用流式读取，而非
file_get_contents()
4. 验证与日志定位（关键步骤）
不要仅靠“调大就完事”，务必检查日志确认真实原因：
- 查看PHP-FPM错误日志：
tail -f /var/log/php{version}-fpm.log，搜索WARNING: [pool www] child .* exited on signal Segmentation fault或timeout - 检查Nginx错误日志：
tail -f /var/log/nginx/error.log，找upstream timed out或recv() failed - 开启PHP-FPM慢日志（取消注释
slowlog = /var/log/php-fpm-slow.log和request_slowlog_timeout = 10s），复现问题后分析卡点
