502错误本质是nginx无法连接php-fpm，主因是fastcgi_pass配置错误、协议不匹配或socket权限不当；需核对php-fpm监听地址、协议及权限，并检查nginx错误日志中的具体连接失败提示。
502 错误本质是 Nginx 连不上 PHP-FPM，而 fastcgi_pass 配置错、不匹配或权限不对，是最常见的直接原因。
确认 PHP-FPM 实际监听地址和协议
PHP-FPM 不一定用 Unix socket，也不一定监听在你认为的位置。必须查真实配置：
- 打开 PHP-FPM 池配置文件，通常是
/etc/php/8.1/fpm/pool.d/www.conf（版本号按实际替换） - 找
listen =这一行，它决定了 PHP-FPM 等待连接的方式和位置，例如：listen = /run/php/php8.1-fpm.sock或listen = 127.0.0.1:9000 - 若为 socket 路径，还要看
listen.owner、listen.group和listen.mode—— 这三者共同决定 Nginx 工作进程能否读写该文件
核对 Nginx 配置中 fastcgi_pass 是否完全一致
哪怕多一个斜杠、少一个空格，Nginx 就会连不上。常见错误包括：
- PHP-FPM 配置的是
listen = /var/run/php/php8.1-fpm.sock，但 Nginx 写成了fastcgi_pass unix:/run/php/php8.1-fpm.sock（路径不一致） - PHP-FPM 监听 TCP（如
listen = 9000），Nginx 却用了fastcgi_pass unix:/tmp/php.sock（协议错配） - PHP-FPM 启用了
listen.allowed_clients = 127.0.0.1，但 Nginx 用的是 socket，这条其实不影响；但如果用 TCP，则必须确保该 IP 在允许列表里
验证 socket 文件是否存在且权限正确
即使配置看起来对，Nginx 也可能因权限被拒而静默失败：
- 运行
ls -l /run/php/php8.1-fpm.sock（路径按实际改），检查输出中 owner/group 是否匹配 Nginx 工作用户（通常是www-data或nginx） - 如果 owner 是
root、group 是www-data，但listen.mode = 0644，Nginx 就能读但不能写——这会导致 502 - 推荐设置：
listen.owner = www-data、listen.group = www-data、listen.mode = 0660，然后确保 Nginx 主配置里user指令也是www-data - 改完记得重启 PHP-FPM：
sudo systemctl restart php8.1-fpm
别忽略日志里那行关键提示
Nginx 错误日志（/var/log/nginx/error.log）里最值得盯住的是类似这样的报错：
connect() to unix:/run/php/php8.1-fpm.sock failed (13: Permission denied)
或
connect() to unix:/run/php/php8.1-fpm.sock failed (2: No such file or directory)
前者说明权限问题，后者说明路径根本不存在或 PHP-FPM 没启动成功——这两类信息比“502 Bad Gateway”本身更有诊断价值。每次改完配置，先看日志再刷新页面。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
