Nginx可通过map模块识别灰度标识、upstream权重配置双后端池、条件路由实现灰度发布，并推荐用OpenResty+Lua动态控制灰度比例与分桶逻辑。
Nginx 本身不直接提供“灰度发布”语义，但可以通过组合 HTTP 头识别 + map 模块 + upstream 权重 + split_clients（或更灵活的 lua） 实现按权重引入灰度流量。核心思路是：**将特定请求（如带灰度标识的用户、Header、Cookie 或参数）定向到灰度后端，其余流量按权重分发到稳定集群；同时支持灰度流量本身也按权重分流（比如 10% 灰度用户中，80% 走灰度 v2，20% 仍走 v1）**。
1. 基于请求特征识别灰度身份（map + 变量）
用 map 提取灰度标识并生成控制变量，例如优先检查 Header，再 fallback 到 Cookie 或参数：
map $http_x_gray_flag $gray_group {
default "";
"v2" "v2";
"v2-beta" "v2-beta";
}
<p>map $cookie_gray_id $gray_group_cookie {
~^[a-f0-9]{8} "v2";
default "";
}</p><p>map $arg_gray $gray_group_arg {
"1" "v2";
default "";
}</p><h1>合并优先级：Header > Cookie > Query</h1><p>map "$http_x_gray_flag:$cookie_gray_id:$arg_gray" $upstream_group {
~^v2:.<em>:.</em> "gray";
~^:.<em>[a-f0-9]{8}:.</em> "gray";
~^:.*:1 "gray";
default "stable";
}</p>2. 定义带权重的 upstream（支持灰度/稳定双池）
为灰度和稳定环境分别定义 upstream，并在灰度池内也设置权重（实现“灰度中再灰度”）：
upstream stable_backend {
server 10.0.1.10:8080 weight=8;
server 10.0.1.11:8080 weight=2;
}
<p>upstream gray_backend {</p><h1>v2 主版本（80%）</h1><pre class="brush:php;toolbar:false;">server 10.0.2.10:8080 weight=8;
# v2-beta 小流量验证（20%）
server 10.0.2.11:8080 weight=2;}
3. 在 location 中按 group 路由 + 透传灰度标识
根据 $upstream_group 变量选择 upstream，并确保下游服务能感知灰度上下文（如透传 Header）：
location / {
proxy_set_header X-Gray-Group $upstream_group;
proxy_set_header X-Real-IP $remote_addr;
<pre class="brush:php;toolbar:false;">if ($upstream_group = "gray") {
proxy_pass http://gray_backend;
proxy_set_header X-Gray-Flag "true";
}
if ($upstream_group = "stable") {
proxy_pass http://stable_backend;
proxy_set_header X-Gray-Flag "false";
}}
⚠️ 注意：if 在 location 中有局限（不能嵌套 proxy_pass），生产建议改用 try_files + 内部 location，或更推荐——
4. 进阶：用 Lua（OpenResty）实现动态灰度权重与规则（推荐）
若需运行时调整灰度比例、AB 测试、用户 ID 哈希分桶等复杂逻辑，Nginx 官方配置难维护，建议接入 OpenResty + lua-resty-balancer：
- 在
init_by_lua_block加载灰度规则（从 Redis 或本地 JSON） - 用
access_by_lua_block解析请求、计算灰度分组（如对 user_id md5 取模） - 通过
balancer_by_lua_block动态选择 upstream server 并设置权重 - 示例逻辑：若
md5(user_id) % 100 → 分配到灰度池；再在灰度池内按 7:3 选 v2/v2-beta
不复杂但容易忽略：所有灰度相关 Header（如 X-Gray-Flag）需在整条链路透传，否则下游网关或服务无法做二次决策；同时建议配合日志记录 $upstream_group 和上游地址，便于灰度流量审计与回溯。
