502错误主因是Nginx与PHP-FPM通信失败。需确认phpEnv运行模式为Nginx+PHP-FPM，检查PHP-FPM是否启动、端口（如9000）是否被占、listen地址与Nginx的fastcgi_pass是否一致，并核对error.log中的具体报错。
phpEnv 是 Windows 下的轻量级 PHP 开发环境套件，底层用的是 Apache 或 Nginx + PHP-FPM 组合（具体看版本），报 502 说明前端服务器（通常是 Nginx）没能从 PHP-FPM 拿到响应——不是代码写错了，而是服务链断了。
确认 phpEnv 当前用的是 Nginx + PHP-FPM
phpEnv 默认可能启 Apache，但 502 只会在反向代理场景（即 Nginx 转发给 PHP-FPM）下出现。先查清实际运行模式：
- 打开 phpEnv 控制面板，看「Web Server」栏显示的是
Nginx还是Apache；若显示Apache，那根本不会报 502，而是 500 或白屏——此时应检查error.log里是否有 PHP 解析失败、扩展没加载等报错 - 若确为
Nginx模式，它默认监听127.0.0.1:9000，并期望 PHP-FPM 在该地址上提供服务；但 phpEnv 的 PHP-FPM 有时会因权限或端口占用改用 socket，而 Nginx 配置没同步更新，就会直接 502 - 进 phpEnv 安装目录（如
C:\phpEnv\php\8.1\fpm\），检查php-fpm.conf里listen值：如果是127.0.0.1:9000，Nginx 的fastcgi_pass就必须匹配；如果是tcp://127.0.0.1:9001或unix:/path/to/sock，Nginx 配置也得跟着改
检查 PHP-FPM 进程是否真在跑
Windows 下 phpEnv 的 PHP-FPM 很容易“看似启动实则挂掉”，尤其在杀毒软件拦截、端口被占、或配置语法错误时：
- 打开任务管理器 → 「详细信息」页，搜
php-fpm.exe；一个都没看到？说明根本没起来 - 手动进 phpEnv 的 PHP-FPM 目录（如
C:\phpEnv\php\8.1\fpm\），双击运行php-fpm.exe，观察命令行窗口是否闪退；若闪退，说明配置出错，重点查php-fpm.conf里的pid、error_log路径是否存在、是否有中文路径、listen.owner/group在 Windows 下应删掉（不支持） - 若进程存在但 Nginx 仍 502，用
netstat -ano | findstr :9000确认端口是否真被php-fpm.exe占用；如果被其他程序（比如另一个 PHP 环境、Docker）占了，就得改 PHP-FPM 的listen端口，并同步改 Nginx 的fastcgi_pass
核对 Nginx fastcgi_pass 和 PHP-FPM listen 是否一致
这是 phpEnv 下最常踩的坑：界面点“启动”看似成功，但两头配置其实对不上。
立即学习“PHP免费学习笔记（深入）”；
- Nginx 配置文件通常在
C:\phpEnv\nginx\conf\vhosts\下，打开对应站点的 conf，找fastcgi_pass行；常见错误是它写成fastcgi_pass 127.0.0.1:9000;，但 PHP-FPM 实际监听的是127.0.0.1:9001（因为 9000 被占） - PHP-FPM 的
listen值必须是完整地址，例如127.0.0.1:9000或127.0.0.1:9000（注意末尾不能有空格或分号）；Windows 下别用 Unix socket 路径，phpEnv 对unix:/...支持不稳定 - 改完配置后，必须分别重启两个服务：先停掉
php-fpm.exe（任务管理器结束进程），再重新双击启动；然后在 phpEnv 面板里点「Restart Nginx」，不能只点「Start」
查看 Nginx error.log 定位真实原因
phpEnv 的日志藏得深，但 error.log 是唯一能告诉你“为什么连不上”的地方：
- 日志路径一般在
C:\phpEnv\nginx\logs\error.log；用记事本或 VS Code 打开，搜502或connect refused、timeout、no live upstreams - 如果看到
connect() failed (10061: No connection could be made...) while connecting to upstream，就是 PHP-FPM 根本没监听或地址不对 - 如果看到
upstream timed out (110: Connection timed out) while reading response header from upstream，说明 PHP-FPM 启动了，但卡在处理请求（比如max_execution_time太小、或代码死循环），这时要调大fastcgi_read_timeout和request_terminate_timeout - Windows 下还常见
open() "/run/php/php8.1-fpm.sock" failed (2: The system cannot find the path specified)—— 这是 Nginx 配置里写了 Unix socket，但 PHP-FPM 没配，且 Windows 不支持该路径，必须改成 TCP 地址
真正麻烦的不是配置本身，而是 phpEnv 把多层服务封装在图形界面下，让人误以为“点一下就全通了”。实际上每次改配置后，必须手动验证进程、端口、日志三者是否闭环；漏掉任意一环，502 就会准时出现。
