要实现1:9灰度测试，Nginx需用小正整数权重（如9和1）、区分新旧后端地址、启用健康检查（max_fails=1 fail_timeout=10s），并通过响应头验证分流比例。
要实现 1:9 的极端灰度测试（即新版本仅承接约 10% 流量，老版本承接 90%），Nginx 权重配置的关键不是写“1 和 9”，而是用**小基数、正整数、可区分、带健康检查**的组合确保比例真实生效且稳定可控。
权重值必须用小正整数，比例才准
weight 参数本身无单位，只表达相对大小。1:9 是理想比例，但直接写 weight=1 和 weight=9 在高并发或连接复用场景下易因内部调度四舍五入导致实际分流偏离（比如变成 11% 或 8.5%）。更稳妥的做法是：
- 设老版本
weight=9，新版本weight=1—— 适用于低流量验证初期，简单直观 - 若需更高精度（尤其在万级 QPS 下），推荐放大为
weight=90和weight=10，或更优解：weight=9和weight=1已足够，无需盲目增大数值 - 绝对避免小数（如
weight=0.1）、负数或 0（部分 Nginx 版本不支持 weight=0，会导致该节点被忽略但不报错）
upstream 必须明确区分新旧后端
两个服务不能共用同一 IP+端口或同一域名解析结果，否则 Nginx 无法独立调度。正确示例：
- ✅
server 10.0.2.100:8000 weight=9;（v1 老版本） - ✅
server 10.0.2.101:8000 weight=1;（v2 新版本） - ❌
server backend-v1.example.com weight=9;和server backend-v1.example.com weight=1;（同域名 → 同解析 → 实际指向同一组机器，权重失效）
必须启用健康检查并设置合理容错
灰度阶段最怕“静默故障”——新版本偶发超时或返回错误，但 Nginx 还持续转发。加基础健康检查能快速隔离问题节点：
- 在每个
server行后追加：max_fails=1 fail_timeout=10s - 含义：单次失败即暂停向该实例转发 10 秒，避免瞬时异常放大影响灰度判断
- 不建议关闭健康检查，也不宜设成
max_fails=0（等价于禁用）
上线后要能快速验证与回滚
配置 reload 后，不能只看“没报错”，必须确认流量真的按 1:9 分流：
- 让新旧服务在响应头中返回不同标识，例如：
X-App-Version: v1.9.0和X-App-Version: v2.0.0-canary - 用 curl 或脚本批量请求（如 100 次），统计响应头分布，验证是否接近 90/10
- 预设回滚操作：把新版本 server 行临时注释掉，或将其 weight 改为 1 → 0（若版本支持），再
nginx -t && nginx -s reload
不复杂但容易忽略细节。只要后端地址可分、权重用正整数、健康检查开着、响应头标得清，1:9 就能稳稳跑起来。
