Nginx实现API网关级负载均衡需结合路由分发、后端分组、健康检查与限流策略；按路径定义专属upstream与location，启用主动健康检查和proxy_next_upstream熔断，基于API Key或参数做精准限流，并补全网关标准头、长连接及错误响应。
在 Nginx 中实现 API 网关级的负载均衡，核心是把路由分发、后端分组、健康检查和限流策略有机结合起来，而不是只做简单的轮询转发。
按路径定义专属 upstream 与 location
不同接口功能差异大，不能共用一个后端池。比如 /auth/login 和 /data/export 应该走不同服务集群，并配置各自权重与容错策略：
- 在
http块中分别声明 upstream，例如：
upstream auth_backend {<br> server 10.0.1.10:8001 weight=3;<br> server 10.0.1.11:8001;<br> keepalive 64;<br>}
upstream report_backend {<br> least_conn;<br> server 10.0.2.20:9001;<br> server 10.0.2.21:9001 backup;<br>} - 每个
location绑定对应 upstream，并支持路径重写：
location /api/v1/auth/ {<br> rewrite ^/api/v1/auth/(.*)$ /$1 break;<br> proxy_pass http://auth_backend;<br>}
location /api/v1/report/ {<br> rewrite ^/api/v1/report/(.*)$ /$1 break;<br> proxy_pass http://report_backend;<br>}
启用健康检查与自动故障转移
仅靠静态 server 列表不够可靠，需让 Nginx 主动感知后端状态：
- 在 upstream 中开启主动健康检查（需 Nginx Plus 或开源版配合
nginx-module）：health_check interval=5s fails=2 passes=3 uri=/health; - 配置
proxy_next_upstream实现请求级熔断：proxy_next_upstream error timeout http_500 http_502 http_503;
这样当某节点返回超时或 5xx，Nginx 会自动重试下一个可用节点。 - 设置连接与响应超时，避免请求卡死：
proxy_connect_timeout 3s;<br>proxy_read_timeout 10s;<br>proxy_send_timeout 10s;
结合身份与路径做精准限流
API 网关的限流必须区分调用者，不能只按 IP —— 多用户可能共享出口 IP：
- 用请求头（如
$http_x_api_key）或 JWT 解析后的字段作为限流 key：
limit_req_zone $http_x_api_key zone=auth_limit:10m rate=10r/s;<br>limit_req_zone $arg_client_id zone=report_limit:10m rate=2r/s;
- 在对应 location 中启用限流并控制突发容量：
location /api/v1/auth/login {<br> limit_req zone=auth_limit burst=20 nodelay;<br> proxy_pass http://auth_backend;<br>} - 加一层宽松的 IP 限流兜底，防无认证扫描：
limit_req_zone $binary_remote_addr zone=ip_fallback:10m rate=100r/m;<br>limit_req zone=ip_fallback burst=50;
统一网关行为增强可靠性
除了转发逻辑，还需补全网关必备能力：
- 添加标准响应头标识网关身份：
add_header X-API-Gateway "nginx";<br>add_header X-Request-ID "$request_id";
- 启用长连接复用，降低后端连接压力：
proxy_http_version 1.1;<br>proxy_set_header Connection '';<br>keepalive_timeout 60s;
- 自定义错误响应格式，便于前端解析：
error_page 429 /rate-limited.json;<br>location = /rate-limited.json {<br> internal;<br> return 429 '{"code":429,"msg":"Too Many Requests"}';<br>}
