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，避免单个请求拖垮进程池；
  • 规范扩展加载，避免不兼容组合。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！