502错误主因是path_info解析失败、fastcgi通信中断或缓冲区溢出；需检查php-fpm状态、修正path_info传递（用$1捕获或改try_files模式）、调大fastcgi超时与缓冲区，并修复lnmp enable-php.conf中pathinfo逻辑缺陷。
ThinkPHP项目在Linux服务器上部署后访问直接报502 Bad Gateway，页面空白且无任何PHP错误提示，说明Nginx已成功转发请求但PHP-FPM未返回有效响应——这通常不是代码问题，而是PATH_INFO解析失败、FastCGI通信中断或缓冲区溢出导致的网关级阻断。
确认PHP-FPM服务状态与进程健康度
执行 systemctl status php-fpm 或 ps aux | grep php-fpm 查看主进程是否存活；若显示 inactive (dead) 或仅剩几个僵尸进程，说明服务已崩溃。
运行 netstat -anpo | grep "php-fpm" | wc -l 统计当前活跃的worker连接数，若结果接近 php-fpm.conf 中配置的 max_children 值（如默认5），则并发请求被排队甚至丢弃，必然触发502。
立即重启服务：systemctl restart php-fpm；若重启失败，检查 /var/log/php-fpm/www-error.log 中是否有 unable to fork 或 failed to set rlimit 类报错——这表示系统资源（如进程数限制）已达上限，需调整 /etc/security/limits.conf 中的 nproc 值。
修正Nginx对ThinkPHP的PATH_INFO支持
ThinkPHP 5.0/5.1 默认启用PATH_INFO模式路由，而标准Nginx配置不提取PATH_INFO变量，导致php-fpm收到空参数后直接退出，返回502。
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
方法一：替换fastcgi_param指令（推荐用于手动编译Nginx环境）
① 打开站点配置文件（如 /etc/nginx/conf.d/your-site.conf）
② 定位到 location ~ \.php(.*)?$ { 块
③ 删除原 fastcgi_param SCRIPT_FILENAME 行，改为以下两行：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;fastcgi_param PATH_INFO $1;
【注意：$1必须来自正则捕获组，若location匹配写成~ \.php$则$1为空，PATH_INFO将丢失】
方法二：改用try_files兜底（兼容性最强，宝塔/lnmp一键包首选）
在server块内添加：location / { try_files $uri $uri/ /index.php?$query_string; }
再单独定义PHP处理块：location ~ \.php$ { include fastcgi.conf; fastcgi_pass unix:/tmp/php-cgi.sock; fastcgi_index index.php; }
此方式完全绕过PATH_INFO，由ThinkPHP从$_SERVER['QUERY_STRING']解析路由，避免正则误判。
调整FastCGI超时与缓冲区参数
当ThinkPHP执行耗时SQL或大文件导出时，若Nginx等待超时，会主动切断连接并返回502。先检查Nginx错误日志：tail -f /var/log/nginx/error.log，若出现 upstream timed out，说明超时已触发。
编辑 /etc/nginx/nginx.conf 的http块，追加或修改以下三行：fastcgi_connect_timeout 300;fastcgi_send_timeout 300;fastcgi_read_timeout 300;
若日志中出现 upstream sent too big header，则是响应头过大超出默认缓冲。此时需扩大缓冲区：fastcgi_buffer_size 32k;fastcgi_buffers 8 32k;
【关键：buffer_size必须≤buffers中单块大小，否则Nginx启动失败】
保存后执行 nginx -t && nginx -s reload 验证并重载配置。
修复LNMP一键包enable-php.conf中的pathinfo逻辑缺陷
军哥LNMP 1.7+版本的 /usr/local/nginx/conf/enable-php.conf 存在PATH_INFO提取bug：if判断中使用了未声明的变量，导致$fastcgi_script_name2为空，最终SCRIPT_FILENAME拼接出错，php-fpm找不到入口文件。
第一步：用vim打开该文件，搜索 if ($fastcgi_script_name ~ "^(.+\.php)(/.+)$")
第二步：确认其内部存在 set $fastcgi_script_name2 $1; 和 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name2;
第三步：若发现 set $path_info $2; 被注释或缺失，在if块末尾补上：set $path_info $2;fastcgi_param PATH_INFO $path_info;
第四步：执行 lnmp nginx restart 使配置生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
