502 Bad Gateway 是因 Nginx 无法从 PHP-FPM 获取响应所致，需依次检查：PHP-FPM 是否运行及监听正常、fastcgi_pass 配置是否匹配、资源限制（如 pm.max_children）是否触发、超时设置是否合理、以及 root 路径与 SCRIPT_FILENAME 是否一致。
Nginx 1.24.0 与 PHP 8.2.32 组合出现 502 Bad Gateway，说明 Nginx 已成功接收请求，但在尝试将 PHP 请求转发给 PHP-FPM 时失败——上游（PHP-FPM）未返回有效响应。这不是 Nginx 自身崩溃，而是代理链路在“Nginx → PHP-FPM”这一段中断了。需按实际链路逐层验证。
确认 PHP-FPM 服务正在运行且可连接
502 最常见原因是 PHP-FPM 进程未启动、异常退出或监听异常：
- 检查服务状态：
sudo systemctl status php8.2-fpm，确保显示 active (running) - 验证监听方式：若用 Unix socket（推荐），执行
ls -l /run/php/php8.2-fpm.sock，文件需存在且权限允许 Nginx 用户（通常是www-data或nginx）读写；若用 TCP，运行sudo ss -tlnp | grep ':9000'确认端口被 php-fpm 占用 - 临时测试连通性：用
curl --unix-socket /run/php/php8.2-fpm.sock http://localhost/（需 PHP-FPM 配置支持 HTTP 健康检查）或更直接地查看错误日志：sudo tail -f /var/log/php8.2-fpm.log，留意 WARNING 或 ERROR 行（如server reached pm.max_children）
核对 Nginx 配置中 fastcgi_pass 与 upstream 是否匹配
Nginx 的 fastcgi_pass 必须与 PHP-FPM 实际监听地址完全一致，一个字符错误就会导致连接拒绝：
- 打开站点配置（如
/etc/nginx/sites-enabled/default），定位到location ~ \.php$块 - 确认
fastcgi_pass值：Unix socket 写法为unix:/run/php/php8.2-fpm.sock；TCP 写法为127.0.0.1:9000—— 不能混用，也不能多空格、少斜杠 - 检查
include snippets/fastcgi-php.conf;是否存在且未被注释；若无该文件，需手动补全关键参数，至少包含：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;fastcgi_param PATH_INFO $fastcgi_path_info;
检查 PHP-FPM 资源限制是否触发熔断
高并发下，PHP-FPM 可能因子进程耗尽而拒绝新请求，Nginx 等待超时后返回 502：
立即学习“PHP免费学习笔记（深入）”；
- 查看 PHP-FPM 池配置（通常为
/etc/php/8.2/fpm/pool.d/www.conf），重点关注：pm = dynamic（推荐）pm.max_children = 30（根据内存调整，2GB 内存建议 15–25）pm.start_servers = 5pm.min_spare_servers = 5pm.max_spare_servers = 10 - 观察日志是否频繁出现：
WARNING: [pool www] server reached pm.max_children setting，出现即需调高max_children - 同时检查 Nginx 端超时设置是否过短，在
http或server块中加入：fastcgi_connect_timeout 300;fastcgi_send_timeout 300;fastcgi_read_timeout 300;
排除 root 路径与 SCRIPT_FILENAME 不一致问题
当 $document_root$fastcgi_script_name 拼出的 PHP 文件路径不存在，PHP-FPM 会静默失败，Nginx 收不到响应即报 502：
- 确认 Nginx
server块中的root指令指向真实网站根目录，例如：root /var/www/html; - 进入该目录，检查
index.php是否存在，且权限为644，所属用户组可被 PHP-FPM 进程读取（如www-data:www-data） - 避免在
location ~ \.php$内重复定义root，除非有特殊多目录需求；如有，必须与外层root完全一致
