基于服务器配置优化Nginx/PHP-FPM及502 Bad Gateway错误排查

一、先定位502错误的核心原因 #

负载低但频繁出现502，大概率不是CPU资源不足，而是PHP-FPM进程池连接数耗尽、进程异常崩溃，或是Nginx与PHP-FPM的通信队列/超时参数不匹配导致的。先通过日志确认具体原因：

• 查看Nginx错误日志：tail -f /var/log/nginx/error.log，重点关注connect() to unix:/run/php-fpm.sock failed或recv() from upstream failed类报错
• 查看PHP-FPM错误日志：tail -f /var/log/php-fpm/error.log，排查是否存在child exited on signal（进程崩溃）或max_children reached（进程数耗尽）信息

二、PHP-FPM参数计算与配置 #

核心参数计算逻辑 #

PHP-FPM的内存占用是配置核心，先统计单个PHP-FPM进程的内存消耗：

ps aux | grep php-fpm | awk '{sum+=$6} END {print sum/NR/1024 " MB"}'

假设单进程平均占用80MB（主流PHP应用的常规水平），结合32GB内存分配：

• 系统预留4GB（给内核、系统缓存、其他基础服务）
• 剩余28GB分配给PHP-FPM：28*1024 / 80 = 358，取300-350作为pm.max_children（留冗余避免内存耗尽）
• 基于16核CPU：
  • pm.start_servers = 核数*2 = 32（初始启动的进程数）
  • pm.min_spare_servers = 核数*1 =16（最小闲置进程数）
  • pm.max_spare_servers = 核数*3 =48（最大闲置进程数）
• pm.process_idle_timeout：闲置进程回收时间，设为10s即可（避免闲置进程占用内存）

关键通信与限制参数 #

• listen.backlog：PHP-FPM套接字的等待队列，默认值偏小，设为1024（避免连接排队溢出）
• request_terminate_timeout：单个请求的超时时间，设为60s（匹配业务场景，避免慢请求长期占用进程）
• rlimit_files：进程打开文件数限制，设为65535（避免文件句柄不足导致的异常）

示例配置（www.conf） #

pm = dynamic
pm.max_children = 320
pm.start_servers = 32
pm.min_spare_servers = 16
pm.max_spare_servers = 48
pm.process_idle_timeout = 10s;
listen = /run/php-fpm.sock
listen.backlog = 1024
listen.owner = nginx
listen.group = nginx
listen.mode = 0660
request_terminate_timeout = 60s
rlimit_files = 65535

三、Nginx参数匹配配置 #

核心进程与连接参数 #

• worker_processes：设为CPU核数16（充分利用多核资源）
• worker_connections：单进程最大连接数，设为10240（足够应对高并发场景）
• multi_accept on;：允许worker进程一次性接收所有新连接，提升处理效率

反向代理与上游匹配参数 #

要和PHP-FPM的超时、队列参数对应：

• proxy_connect_timeout：连接上游PHP-FPM的超时时间，设为10s
• proxy_send_timeout：发送请求到上游的超时时间，设为60s（和PHP-FPM的request_terminate_timeout保持一致）
• proxy_read_timeout：读取上游响应的超时时间，设为60s
• upstream块添加keepalive 32;：复用与PHP-FPM的连接，减少握手开销

示例配置（nginx.conf） #

worker_processes 16;
worker_connections 10240;
multi_accept on;

http {
    upstream php-fpm {
        server unix:/run/php-fpm.sock;
        keepalive 32;
    }

    server {
        # 站点基础配置（略）
        location ~ \.php$ {
            proxy_pass http://php-fpm;
            proxy_connect_timeout 10s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }
}

四、验证与调优步骤 #

1. 重启服务生效：systemctl restart php-fpm && systemctl restart nginx
2. 实时监控状态：用htop观察内存占用和PHP-FPM进程数，用netstat -s查看套接字队列的溢出情况
3. 逐步微调：如果仍出现502，先尝试将listen.backlog调高到2048；若日志显示进程崩溃，需排查业务代码是否存在内存溢出、段错误等问题

内容的提问来源于stack exchange，提问作者Bobby