LNMP中如何解决502 Bad Gateway错误 - 问答

LNMP出现502 Bad Gateway的定位与修复指南

一、快速判断与定位

含义：Nginx作为反向代理，无法从PHP-FPM获取有效响应，常见于后端崩溃、配置不一致、权限不足或资源耗尽。
先看错误日志：
- Nginx 错误日志（路径以实际为准）：/usr/local/nginx/logs/error.log
- PHP-FPM 日志：/usr/local/php/var/log/php-fpm.log
确认 PHP-FPM 是否在跑：ps -ef | grep php-fpm；若未运行，启动服务并观察日志。
核对监听方式：
- Socket：在 PHP-FPM 配置中的 listen 与 Nginx 的 fastcgi_pass unix:/path.sock; 必须一致；
- TCP：PHP-FPM 为 listen = 127.0.0.1:9000;，Nginx 对应 fastcgi_pass 127.0.0.1:9000;。
语法与重载：
- nginx -t 检查配置；
- nginx -s reload 或 service nginx reload 平滑重载。
若一时难以定位，可临时将 Socket 改为 127.0.0.1:9000 验证是否为通信/权限问题。

二、常见原因与对应修复

配置不一致或路径错误
- 症状：Nginx 与 PHP-FPM 的 socket 路径或端口不一致；或 SCRIPT_FILENAME 指向错误目录。
- 处理：统一两者监听；确保 SCRIPT_FILENAME 为站点真实根目录（如：/data/www$fastcgi_script_name）。
权限问题（Socket 模式）
- 症状：Nginx 以 nobody 运行，无法访问 PHP-FPM 的 .sock 文件。
- 处理：在 PHP-FPM 的 [www] 段设置 listen.owner/listen.group 与 Nginx 运行用户一致；或统一使用 TCP 方式规避权限。
资源耗尽（进程不足）
- 症状：高峰期或并发上来后集中出现 502。
- 处理：调大 pm.max_children；动态模式下同步调整 pm.start_servers、pm.min_spare_servers、pm.max_spare_servers；可按内存经验值：4GB≈150、8GB≈300（需结合实际负载与内存）。
执行超时
- 症状：长脚本或大文件导入导出时 502。
- 处理：在 php.ini 提高 max_execution_time（如 300 秒或按需）；在 PHP-FPM 调整 request_terminate_timeout；必要时同步调大 Nginx 的 fastcgi_read_timeout。
模块/扩展冲突
- 症状：新增或升级扩展后开始 502。
- 处理：逐一禁用可疑扩展（如 eAccelerator/Zend GuardLoader/ionCube/OPcache 的兼容性问题），重启验证。
磁盘空间不足
- 症状：日志或缓存占满磁盘导致进程异常。
- 处理：df -h、du -sh 清理无用文件，释放空间后重启服务。
文件描述符限制过低
- 症状：高并发下偶发 502。
- 处理：提高系统/进程文件句柄限制（如 nofile 65535、rlimit_files），并重启 PHP-FPM。

三、关键配置示例

Nginx 虚拟主机片段（Socket 示例）

server {
    listen 80;
    server_name example.com;
    root  /data/www;
    index index.php index.html;

    location ~ \.php$ {
        include        fastcgi_params;
        fastcgi_pass   unix:/tmp/www.sock;
        fastcgi_index  index.php;
        fastcgi_param SCRIPT_FILENAME  /data/www$fastcgi_script_name;
    }
}

PHP-FPM 片段（与 Nginx 保持一致）

[www]
listen = /tmp/www.sock
user  = php-fpm
group = php-fpm
listen.owner = nobody
listen.group = nobody

pm = dynamic
pm.max_children = 150
pm.start_servers = 20
pm.min_spare_servers = 5
pm.max_spare_servers = 35
pm.max_requests = 500

变更后执行：nginx -t && nginx -s reload && service php-fpm restart。

四、临时兜底与长期优化

临时兜底（不建议长期依赖）

监控某 URL，返回 502 时自动重启 PHP-FPM（示例脚本思路）：

#!/bin/bash
url="https://yourdomain.com"
code=$(curl -o /dev/null -m 10 -s -w "%{http_code}" "$url")
if [ "$code" = "502" ]; then
    /etc/init.d/php-fpm restart
    echo "$(date) $url $code 重启PHP-FPM" >> /var/log/502_monitor.log
fi

加入 crontab 每 2 分钟执行一次。

长期优化
- 建立基线：记录 CPU/内存/连接数/502 次数；
- 优化应用与数据库慢查询；
- 为 PHP-FPM 设置合理 max_children 与 request_terminate_timeout，避免单个请求拖垮进程池；
- 规范扩展加载，避免不兼容组合。

0 赞

0 踩