502 Bad Gateway在Nginx+PHP-FPM独立环境中主因是二者通信失败，需依次检查PHP-FPM进程状态与socket监听、fastcgi_pass与listen地址一致性、pm.max_children资源限制及PATH_INFO解析错误。
502 Bad Gateway 在 PHP 独立环境中（即 Nginx + PHP-FPM 组合，无 Apache、无宝塔、无 Docker 封装）出现，基本可锁定为 PHP-FPM 与 Nginx 之间的通信链路断裂——不是网站代码问题，也不是浏览器或网络问题，而是本地服务间“传话失败”。下面按真实排查顺序给出可立即执行的操作。
确认 PHP-FPM 进程是否存活且监听正确
这是 80% 的 502 根源。别跳过这步直接改配置。
- 运行
sudo systemctl status php8.2-fpm（版本号请替换成你实际安装的，如php8.1-fpm），必须看到active (running)；若为inactive或failed，先执行sudo systemctl start php8.2-fpm - 检查监听方式：用
ls -l /run/php/php8.2-fpm.sock看 Unix socket 文件是否存在；若不存在，说明 PHP-FPM 没有按 socket 模式启动——去查/etc/php/8.2/fpm/pool.d/www.conf中的listen =行，确保它写的是listen = /run/php/php8.2-fpm.sock（不是127.0.0.1:9000） - 验证权限：socket 文件属主应为
www-data（Debian/Ubuntu）或nginx（CentOS/RHEL），且权限为srw-rw----；若 Nginx 用户无法读写该文件，connect() to unix:/run/php/php8.2-fpm.sock failed (111: Connection refused)就必然发生
核对 Nginx fastcgi_pass 与 PHP-FPM listen 地址是否完全一致
一个空格、一个斜杠、一个版本号错误，都会让 Nginx 连不上。常见于手动升级 PHP 后忘记同步配置。
- 打开站点配置（如
/etc/nginx/sites-enabled/default），定位到location ~ \.php$块 - 检查
fastcgi_pass值：如果 PHP-FPM 的listen = /run/php/php8.2-fpm.sock，那么这里必须是fastcgi_pass unix:/run/php/php8.2-fpm.sock;；不能写成/var/run/php/...、不能漏掉unix:前缀、不能多一个空格 - 确认
include snippets/fastcgi-php.conf;存在且未被注释；若该文件丢失，需至少补全两行关键参数：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;和fastcgi_param PATH_INFO $fastcgi_path_info;
检查 PHP-FPM 是否因资源耗尽主动拒绝请求
进程没挂，但已“装死”——这是高并发下最隐蔽的 502 原因，日志里通常带 server reached pm.max_children setting。
立即学习“PHP免费学习笔记（深入）”；
- 查看 PHP-FPM 错误日志：
sudo tail -f /var/log/php8.2-fpm.log，滚动中留意WARNING级日志 - 打开池配置
/etc/php/8.2/fpm/pool.d/www.conf，重点看这几项：pm = dynamic、pm.max_children = 20（2GB 内存建议设为 15–25）、pm.start_servers = 4、pm.min_spare_servers = 4、pm.max_spare_servers = 10 - 调大后务必重启服务：
sudo systemctl restart php8.2-fpm；只 reload 不会重载pm.*参数
排除 PATH_INFO 解析错误导致的 SCRIPT_FILENAME 为空
尤其在 ThinkPHP、Laravel 等依赖 PATH_INFO 的框架中，Nginx 正则写错会让 $fastcgi_script_name 变成空或非法路径，PHP-FPM 直接返回 Primary script unknown，Nginx 收不到任何响应就报 502。
- 错误典型表现：
FastCGI sent in stderr: "Primary script unknown"或No input file specified出现在 Nginx error.log 中 - 禁用所有带
(.*)?的 location 正则，例如删掉location ~ \.php(.*)?$这类规则 - 改用安全模式：在
server块内只保留标准两段：location / { try_files $uri $uri/ /index.php?$query_string; } location ~ \.php$ { include fastcgi.conf; fastcgi_pass unix:/run/php/php8.2-fpm.sock; fastcgi_index index.php; }
真正棘手的 502 往往卡在权限、PATH_INFO、或 pm.max_children 这三个点上——它们不报错，但让整个链路静默失效。每次修改后务必用 sudo nginx -t 测试语法，并用 sudo tail -f /var/log/nginx/error.log 实时盯住错误输出，比猜更可靠。
