Nginx API 网关性能调优实战：从诊断到优化全流程

场景

某电商平台使用 Nginx 作为 API 网关，负责路由和限流。近期大促流量激增，网关出现高延迟和部分请求超时，影响用户体验。

症状

• API 响应时间从平均 50ms 飙升到 500ms+；
• 客户端收到 504 错误比例超过 5%；
• Nginx 错误日志出现大量 upstream timed out。

诊断

1. 检查 Nginx 工作进程：ps aux | grep nginx 确认工作进程数是否匹配 CPU 核数。
2. 连接状态统计：curl http://localhost/nginx_status（需开启 stub_status 模块）查看活跃连接数、等待队列。
3. 上游响应时间：启用 access_log 并分析上游耗时：tail -f /var/log/nginx/access.log | awk '{print $NF}'。
4. 系统资源：top -bn1 | head -20 观察 CPU/内存使用；vmstat 1 10 检查上下文切换。

调优命令

编辑 /etc/nginx/nginx.conf 核心参数：

events {
    worker_connections 4096;      # 每个 worker 的最大连接数，根据 ulimit -n 调整
    use epoll;                    # Linux 下高性能事件模型
    multi_accept on;              # 一次接受所有新连接
}
http {
    keepalive_timeout 65;
    keepalive_requests 1000;      # 单个 keepalive 连接最大请求数
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    upstream backend {
        keepalive 32;             # 上游连接池大小
        server 10.0.0.1:8080;
    }
    server {
        location /api/ {
            proxy_pass http://backend;
            proxy_buffer_size 8k;  # 增大缓冲区减少磁盘 IO
            proxy_buffers 8 8k;
            proxy_busy_buffers_size 16k;
        }
    }
}

测试配置：nginx -t，然后平滑重载：nginx -s reload。

风险控制

• 在低峰期执行变更；
• 保留原配置文件备份：cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak；
• 逐步调整参数，观察监控曲线；
• 准备回滚脚本。

回滚

如果重载后出现问题：

cp /etc/nginx/nginx.conf.bak /etc/nginx/nginx.conf
nginx -t && nginx -s reload

验证

1. 压力测试：ab -n 10000 -c 200 https://your-api.example.com/api/，观察响应时间与错误率。
2. 实时监控：使用 nginx -T 转储配置后，通过 tail -f /var/log/nginx/access.log 观察请求耗时。
3. 比较前后指标：延迟、吞吐量、错误率。

何时提交 OpsGlobal 工单

• 经过上述调优后仍无法满足性能指标；
• 需要调整内核参数（如 net.core.somaxconn）或系统层面优化；
• 遇到 Nginx 自身 bug 或需要定制模块；
• 缺乏生产环境变更窗口或需要专属 SLA。