PHP独立环境出现502 Bad Gateway怎么解决？-php教程-PHP中文网

502 bad gateway在nginx+php-fpm独立环境中主因是二者通信失败，需依次检查php-fpm进程状态与socket监听、fastcgi_pass与listen地址一致性、pm.max_children资源限制及path_info解析错误。

php独立环境出现502 bad gateway怎么解决？

502 Bad Gateway 在 PHP 独立环境中（即 Nginx + PHP-FPM 组合，无 Apache、无宝塔、无 Docker 封装）出现，基本可锁定为 PHP-FPM 与 Nginx 之间的通信链路断裂——不是网站代码问题，也不是浏览器或网络问题，而是本地服务间“传话失败”。下面按真实排查顺序给出可立即执行的操作。

确认 PHP-FPM 进程是否存活且监听正确

这是 80% 的 502 根源。别跳过这步直接改配置。

运行 sudo systemctl status php8.2-fpm（版本号请替换成你实际安装的，如 php8.1-fpm），必须看到 active (running)；若为 inactive 或 failed，先执行 sudo systemctl start php8.2-fpm
检查监听方式：用 ls -l /run/php/php8.2-fpm.sock 看 Unix socket 文件是否存在；若不存在，说明 PHP-FPM 没有按 socket 模式启动——去查 /etc/php/8.2/fpm/pool.d/www.conf 中的 listen = 行，确保它写的是 listen = /run/php/php8.2-fpm.sock（不是 127.0.0.1:9000）
验证权限：socket 文件属主应为 www-data（Debian/Ubuntu）或 nginx（CentOS/RHEL），且权限为 srw-rw----；若 Nginx 用户无法读写该文件，connect() to unix:/run/php/php8.2-fpm.sock failed (111: Connection refused) 就必然发生

核对 Nginx fastcgi_pass 与 PHP-FPM listen 地址是否完全一致

一个空格、一个斜杠、一个版本号错误，都会让 Nginx 连不上。常见于手动升级 PHP 后忘记同步配置。

Android SMS Gateway

自托管短信服务，使用 Android 手机作为网关提供 HTTP API，支持发送/接收短信，兼容主流短信网关。

下载

打开站点配置（如 /etc/nginx/sites-enabled/default），定位到 location ~ \.php$ 块
检查 fastcgi_pass 值：如果 PHP-FPM 的 listen = /run/php/php8.2-fpm.sock，那么这里必须是 fastcgi_pass unix:/run/php/php8.2-fpm.sock;；不能写成 /var/run/php/...、不能漏掉 unix: 前缀、不能多一个空格
确认 include snippets/fastcgi-php.conf; 存在且未被注释；若该文件丢失，需至少补全两行关键参数：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 和 fastcgi_param PATH_INFO $fastcgi_path_info;

检查 PHP-FPM 是否因资源耗尽主动拒绝请求

进程没挂，但已“装死”——这是高并发下最隐蔽的 502 原因，日志里通常带 server reached pm.max_children setting。

查看 PHP-FPM 错误日志：sudo tail -f /var/log/php8.2-fpm.log，滚动中留意 WARNING 级日志
打开池配置 /etc/php/8.2/fpm/pool.d/www.conf，重点看这几项：pm = dynamic、pm.max_children = 20（2GB 内存建议设为 15–25）、pm.start_servers = 4、pm.min_spare_servers = 4、pm.max_spare_servers = 10
调大后务必重启服务：sudo systemctl restart php8.2-fpm；只 reload 不会重载 pm.* 参数

排除 PATH_INFO 解析错误导致的 SCRIPT_FILENAME 为空

尤其在 ThinkPHP、Laravel 等依赖 PATH_INFO 的框架中，Nginx 正则写错会让 $fastcgi_script_name 变成空或非法路径，PHP-FPM 直接返回 Primary script unknown，Nginx 收不到任何响应就报 502。

错误典型表现：FastCGI sent in stderr: "Primary script unknown" 或 No input file specified 出现在 Nginx error.log 中
禁用所有带 (.*)? 的 location 正则，例如删掉 location ~ \.php(.*)?$ 这类规则

改用安全模式：在 server 块内只保留标准两段：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
    include fastcgi.conf;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    fastcgi_index index.php;
}

真正棘手的 502 往往卡在权限、PATH_INFO、或 pm.max_children 这三个点上——它们不报错，但让整个链路静默失效。每次修改后务必用 sudo nginx -t 测试语法，并用 sudo tail -f /var/log/nginx/error.log 实时盯住错误输出，比猜更可靠。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！