phpEnv 本身不直接引发 502 错误，根本原因是 Nginx 无法从 PHP-FPM 获取响应；需依次检查 PHP-FPM 进程状态、fastcgi_pass 与监听方式是否匹配、子进程配置是否合理，并优先查阅 ~/.phpenv/logs/ 下的 Nginx 和 PHP-FPM 日志定位问题。
phpEnv 本身不直接引发 502，但它是 Nginx + PHP-FPM 组合的封装工具，502 实质仍是 Nginx 无法从 PHP-FPM 拿到响应 —— 所以排查路径和原生环境一致，只是配置位置和启动方式有差异。
phpEnv 中 PHP-FPM 是否在运行
phpEnv 启动后，PHP-FPM 进程默认由它管理，但可能因配置错误、端口冲突或权限问题静默退出。不能只看 phpEnv 的启动提示，要实际验证进程是否存在：
- 执行
ps aux | grep php-fpm，确认有带master process字样的进程（不是仅剩几个 worker） - 若无输出，说明 PHP-FPM 没起来；执行
phpenv restart（或phpenv start）后仍失败，就查日志：tail -n 20 ~/.phpenv/logs/php-fpm.log - 常见报错如
unable to bind listening socket，说明端口（默认 9000）或 socket 文件被占用，需用lsof -i :9000或ls -l /tmp/php-cgi.sock检查
Nginx fastcgi_pass 是否匹配 phpEnv 的 PHP-FPM 监听方式
phpEnv 默认使用 TCP（127.0.0.1:9000），但部分版本或手动改配后可能切到 Unix socket（如 /tmp/php-cgi.sock）。Nginx 配置里 fastcgi_pass 必须与之完全一致：
- 查 phpEnv 的 PHP-FPM 实际监听地址：打开
~/.phpenv/etc/php-fpm.d/www.conf，看listen =行值 - 再查 Nginx 站点配置（通常在
~/.phpenv/nginx/conf/vhost/xxx.conf），核对fastcgi_pass是否与之匹配 - 若 PHP-FPM listen 是
127.0.0.1:9000，Nginx 却写成fastcgi_pass unix:/tmp/php-cgi.sock，必然 502 - 注意：phpEnv 的 socket 文件默认在
/tmp/下，权限常为root:root，而 Nginx worker 一般以www-data或daemon身份运行，需确保组可读写
phpEnv 的 PHP-FPM 子进程是否被耗尽或卡死
phpEnv 封装的 PHP-FPM 仍受 pm.max_children 等参数约束，高并发下容易打满。它的默认配置往往偏保守（如 max_children = 5），远低于生产需求：
Gateway Restart Profiler
下载
OpenClaw Gateway 重启性能分析工具：分析重启速度、定位启动慢原因、生成性能报告、诊断启动问题。支持 Windows (PowerShell) 与 Linux (Bash)。触发场景：分析 gateway 重启、检查启动时间、生成报告、诊断异常。
立即学习“PHP免费学习笔记（深入）”；
- 编辑
~/.phpenv/etc/php-fpm.d/www.conf，检查并调整以下几项： -
pm = dynamic（不建议 static） -
pm.max_children = 20（4GB 内存机器起步值，按每个 PHP 进程约 60–80MB 估算） -
pm.start_servers = 5、pm.min_spare_servers = 3、pm.max_spare_servers = 10 -
request_terminate_timeout = 300（必须 ≥ Nginx 的fastcgi_read_timeout） - 改完执行
phpenv restart生效，别只 reload
phpEnv 日志在哪？关键错误藏在这些文件里
phpEnv 把日志集中放在 ~/.phpenv/logs/，比全局路径更易定位，但很多人忽略它们：
-
~/.phpenv/logs/nginx.error.log：第一手线索，搜upstream timed out、Connection refused、no live upstreams -
~/.phpenv/logs/php-fpm.log：记录启动失败、子进程异常退出、权限拒绝等底层错误 -
~/.phpenv/logs/php-fpm-slow.log（若启用）：慢请求堆栈，能暴露卡在 cURL、PDO::query 或 file_get_contents 的脚本 - 注意：phpEnv 默认不开启 slow log，需手动在
www.conf加slowlog = /path/to/slow.log和request_slowlog_timeout = 5s
phpEnv 的便利性掩盖了它对底层通信链路的强依赖 —— 一个错位的 fastcgi_pass、一行漏掉的 listen.group、或者没重载的配置，都足以让整个链路静默断裂。动手前先看日志，别急着调参。
