502 Bad Gateway几乎总是因Nginx无法与PHP-FPM有效通信，根因常为Unix socket监听权限不匹配：listen.owner/group须与Nginx worker用户（如www-data）一致，listen.mode须设为0660，fastcgi_pass路径须与PHP-FPM的listen完全一致，socket残留时应手动删除后重启。
502 Bad Gateway 几乎总是因为 Nginx 无法与 PHP-FPM 建立有效通信，而监听权限不匹配是其中最常被忽略的根因。
PHP-FPM 的 listen.owner 和 listen.group 必须与 Nginx worker 进程用户一致
Unix socket 文件（如 /run/php/php8.2-fpm.sock）不是普通文件，它的访问控制完全依赖于文件系统权限和所属用户/组。Nginx worker 进程默认以 www-data（Ubuntu/Debian）或 nginx（CentOS/RHEL）身份运行；如果 PHP-FPM 创建 socket 时设了 listen.owner = www-data 但 listen.group = apache，而 Nginx 实际属于 www-data 组，那它就无权写入该 socket —— 请求直接被拒绝，Nginx 返回 502。
- 查 Nginx 用户：
ps aux | grep nginx看 worker 进程的 USER 列，或检查/etc/nginx/nginx.conf中的user指令 - 查 PHP-FPM 当前配置：
grep -E "^(user|group|listen.owner|listen.group)" /etc/php/8.2/fpm/pool.d/www.conf - 必须确保：
listen.owner和listen.group都设为 Nginx worker 所属的同一用户/组（通常是www-data） - 改完后务必重启：
sudo systemctl restart php8.2-fpm，再确认 socket 文件属主：ls -l /run/php/php8.2-fpm.sock
socket 文件权限 listen.mode 不能是 0644 或 0600
0644 表示只有 owner 可读写，group 和 other 只读 —— Nginx worker 若不在 owner 位置，连读都失败；0600 更糟，仅 owner 可读写。PHP-FPM 默认生成的 socket 权限是 0660，这正是正确值：owner 和 group 都可读写，other 完全无权。
OpenClaw Gateway 重启性能分析工具：分析重启速度、定位启动慢原因、生成性能报告、诊断启动问题。支持 Windows (PowerShell) 与 Linux (Bash)。触发场景：分析 gateway 重启、检查启动时间、生成报告、诊断异常。
- 在
www.conf中显式设置：listen.mode = 0660（不要省略前导零） - 避免用
chmod 777临时“修复”——这会绕过权限模型，且可能触发 SELinux 或安全审计告警 - 改完重启 PHP-FPM 后，立即验证：
ls -l /run/php/php8.2-fpm.sock输出应类似srw-rw---- 1 www-data www-data ...
Nginx 的 fastcgi_pass 路径必须与 PHP-FPM 的 listen 完全一致
路径差一个字符（比如 /run/php/php8.2-fpm.sock vs /var/run/php/php8.2-fpm.sock）或协议类型不匹配（socket 写成 TCP），都会让 Nginx 尝试连接一个根本不存在的地址，超时后直接报 502。
立即学习“PHP免费学习笔记（深入）”；
- 在
www.conf中确认listen = /run/php/php8.2-fpm.sock（注意：Ubuntu 标准路径是/run/php/，不是/var/run/php/） - 在 Nginx 配置中检查
fastcgi_pass unix:/run/php/php8.2-fpm.sock;——unix:前缀不能漏，路径必须一字不差 - 别信网上某些教程说 “
/var/run是/run的符号链接所以等价”，systemd 临时文件系统下二者行为不同，硬链接也未必存在 - 修改后执行：
sudo nginx -t && sudo systemctl reload nginx
最容易被跳过的其实是 socket 文件的生命周期：PHP-FPM 重启时会删掉旧 socket 并新建，但如果上一次崩溃导致 socket 文件残留且权限错乱，新进程可能无法覆盖它。遇到改完配置仍 502，先手动删掉 socket 文件再重启 PHP-FPM，比反复调参数更高效。
