502 bad gateway 表明 nginx 无法从 php-fpm 获取有效响应，常见于 phpenv 下进程未运行、fastcgi_pass 与 listen 地址不一致、socket 权限不足或配置错误，需逐项排查进程、配置、权限及日志。
502 Bad Gateway 表示 Nginx 作为网关，没能从 PHP-FPM 拿到有效响应——不是 PHP 脚本跑慢了（那是 504），而是根本连不上、连上了又断开、或进程压根没起来。phpEnv 环境下尤其容易因版本切换导致配置错位、路径不一致、权限缺失等问题。
确认 php-fpm 进程是否真实运行
phpEnv 界面显示“已启动”，不代表 php-fpm 进程在后台持续运行。必须手动验证：
- 执行 ps aux | grep php-fpm，检查是否有对应版本的 master 进程（如带
-y ~/.phpenv/versions/8.1.27/etc/php-fpm.conf的进程） - 若无进程，需手动启动：
~/.phpenv/versions/8.1.27/sbin/php-fpm -c ~/.phpenv/versions/8.1.27/etc/php.ini -y ~/.phpenv/versions/8.1.27/etc/php-fpm.conf - 启动后再次检查进程是否存在；若启动即退出，说明有静默错误，必须查日志
核对 fastcgi_pass 与 php-fpm listen 地址是否完全一致
这是 phpEnv 下最常见、最易忽略的错——Nginx 配置写的是 127.0.0.1:9000，而 php-fpm 实际监听的是 unix:/tmp/php-fpm.sock，一字不差才可能通。
ucp-gateway-skill
下载
搜索商品、准备购物车、发布 UCP 个人资料，并通过 The Agent Times UCP Gateway 创建买家确认的商家结账流程。UCP Gateway 是面向支持 UCP 的电商平台构建的购物基础设施层，其核心为 Universal Commerce Protocol（通用商业协议）。
- 打开当前激活 PHP 版本的
php-fpm.conf，定位listen =行，记下完整值（含空格、斜杠方向、IP 写法） - 打开站点 Nginx 配置（如
/www/server/panel/vhost/nginx/xxx.conf），找到location ~ \.php块内的fastcgi_pass，确保两者字符级完全相同 - 若用 Unix socket，执行
ls -l /tmp/php-fpm.sock确认文件存在；若不存在，php-fpm 启动会失败
检查 socket 文件权限与用户归属
即使路径对、进程在，Nginx worker 进程（通常是 www 或 nginx 用户）若无 socket 读写权限，照样 502。
- 执行
ls -l /tmp/php-fpm.sock，查看属主和权限（推荐srw-rw----） - 若属主不是
www，运行：chown www:www /tmp/php-fpm.sock - 若权限不足，运行：
chmod 660 /tmp/php-fpm.sock - 注意：修改后需重启 php-fpm 和 reload nginx 才生效
查看错误日志定位静默失败原因
php-fpm 启动失败常不报错，只退出。不看日志，永远卡在“为什么连不上”。
- 先查 php-fpm 错误日志位置：打开
php-fpm.conf，找error_log =对应路径（常见于~/.phpenv/versions/x.x.x/var/log/php-fpm.log） - 典型报错包括：
—Address already in use（端口或 socket 被占）
—failed to load configuration file（ini 路径错误）
—Unknown pool section（fpm.d/*.conf 格式非法） - 临时加调试：启动时加
-F -d log_level=debug，例如：php-fpm -F -c php.ini -y php-fpm.conf -d log_level=debug
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
