nginx 原生轮询(round-robin)本身不支持灰度发布,必须通过 upstream 模块的权重分配或结合 map 指令实现分流。具体做法是:在 upstream 中为旧版服务器设置较高权重、新版设置较低权重,或通过 map 根据请求头/cookie 将流量动态路由到不同后端组;重启 nginx 后,按权重比例或条件匹配即可实现灰度流量控制。

如何基于权重实现按比例灰度?
通过 weight 参数调整 upstream 中各服务器的访问概率,例如 90% 流量走旧版、10% 走新版。配置时需确保新旧版本接口兼容,否则低版本节点可能报错。Nginx 默认使用加权轮询,权重越高被选中频率越大,适合渐进式放量。

server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
}
}
upstream backend {
server 192.168.1.10:8080 weight=9; # 旧版 90%
server 192.168.1.11:8080 weight=1; # 新版 10%
}
预期结果:每 10 次请求中约 9 次转发至 192.168.1.10,1 次转发至 192.168.1.11。实际分布因哈希和连接复用略有波动,但长期趋近权重比例。若新版返回错误,可立即降低其权重或暂时移除。
如何基于用户标识实现精准灰度?
使用 map 指令解析 Cookie 或 Header 中的用户 ID,将其映射到特定 upstream 组。例如,对测试账号或白名单用户强制指向新版服务,其余用户仍走旧版。此方式不依赖随机概率,适合 A/B 测试或功能验证。

map $cookie_user_id $target_backend {
default old_group;
"test_user" new_group;
"admin_001" new_group;
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://$target_backend;
}
}
upstream old_group {
server 192.168.1.10:8080;
}
upstream new_group {
server 192.168.1.11:8080;
}
预期结果:user_id=test_user 的请求始终路由至 new_group,其他用户路由至 old_group。该机制依赖客户端携带正确 Cookie,若未设置则 fallback 至默认旧版。适用于需要稳定会话绑定的灰度场景。
当新版服务返回 502 时,Nginx 如何处理故障转移?
Nginx 默认启用健康检查机制,若某节点连续失败(如返回 502),会自动将其从可用池中剔除,并将流量重定向至其他正常节点。无需手动干预,系统具备自愈能力。可通过 max_fails 和 fail_timeout 控制检测频率与恢复时间。


















