Nginx与API网关中间件性能调优实战指南

场景

某电商平台使用Nginx作为API网关中间件，负责路由、限流、缓存等功能。近期大促活动期间，用户反馈API响应缓慢，部分请求超时。

症状

• API响应延迟从平均50ms飙升到500ms以上
• 错误率从0.5%上升到5%
• Nginx进程CPU占用率持续超过80%
• 内存使用量异常增长

诊断

1. 检查Nginx访问日志：tail -f /var/log/nginx/access.log 观察响应时间分布。
2. 检查错误日志：tail -f /var/log/nginx/error.log 寻找连接超时、worker崩溃等信息。
3. 启用状态模块：在server块中添加： location /nginx_status { stub_status; } 然后访问 /nginx_status 获取活跃连接数、请求处理数等指标。
4. 压力测试：使用ab -n 10000 -c 100 http://localhost/nginx_status 模拟并发，观察性能瓶颈。
5. 分析配置：检查worker_processes、worker_connections、keepalive、proxy_buffers等参数是否合理。

调优命令

# 测试配置语法
nginx -t

# 平滑重载配置
nginx -s reload

# 调整worker进程数（根据CPU核心数）
worker_processes auto;
# 或手动设为CPU核心数的1-2倍

# 增加worker连接数
events {
    worker_connections 4096;
    use epoll;
    multi_accept on;
}

# 优化缓存和缓冲区
proxy_buffers 8 16k;
proxy_buffer_size 16k;
proxy_busy_buffers_size 24k;

# 启用keepalive连接
gzip on;
gzip_min_length 1000;
upstream backend {
    keepalive 32;
}

# 限制连接数（限流）
limit_conn_zone $binary_remote_addr zone=addr:10m;
limit_conn addr 10;

风险控制

• 修改配置前备份原文件：cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak
• 先用nginx -t验证语法，再执行nginx -s reload
• 避免在生产高峰期间修改核心参数
• 每次调整后监控至少10分钟

回滚策略

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

确认恢复后，检查错误日志和响应时间。

验证

• 使用curl -o /dev/null -s -w %{time_total}\n http://api.example.com/status 测量响应时间
• 观察Nginx状态页中的活跃连接数是否下降
• 对比调优前后的压力测试结果
• 确认错误率降至正常水平

何时提交OpsGlobal工单

• 调优后性能改善仍不达标
• 出现worker进程频繁崩溃
• 上游服务器响应正常但Nginx代理异常
• 配置复杂无法确定瓶颈时