在 nginx 的轮询（round robin）模式下，实现灰度发布的核心做法是修改 upstream 配置中的权重参数。通过为特定服务器节点设置较高的 weight 值，使其承担大部分流量，而将少量流量分配给运行新版本代码的节点，从而达成灰度效果。
如何配置权重以实现流量分流
直接回答：在 upstream 块中，使用 weight 指令指定每个服务器的权重比例。Nginx 会根据权重大小按比例分配请求，权重高的节点接收更多请求。
upstream backend {
server 192.168.1.10:8080 weight=9;
server 192.168.1.11:8080 weight=1;
}
在上述配置中，假设两个节点分别运行旧版和新版应用。每 10 个请求中，约有 9 个会被转发到 192.168.1.10（旧版），1 个会被转发到 192.168.1.11（新版）。这种基于权重的轮询确保了流量按预期比例分布，无需引入复杂的负载均衡算法或外部服务。
如何验证灰度流量的实际分布
直接回答：通过检查响应头或日志中的标识字段，可以确认请求是否被正确分发到了目标节点。结合 Nginx 的访问日志和后端应用的记录，能够直观看到流量占比是否符合配置的权重。
# 在 Nginx 配置中添加日志格式以追踪来源
log_format graylog '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent"';
access_log /var/log/nginx/gray_access.log graylog;
当请求到达后端时，可以在应用层添加逻辑，例如在响应头中返回当前运行的版本信息。通过统计日志中不同版本响应的数量，即可验证灰度发布的流量比例。若发现流量分布不均，需检查 Nginx 的健康检查状态及网络连通性，确保所有节点均处于正常工作状态。
当新节点返回错误时如何处理
直接回答：如果灰度节点（低权重节点）在处理请求时返回 5xx 错误，Nginx 默认会将该请求重试并转发到其他正常节点。这保证了用户不会因单个节点故障而看到错误页面，同时允许运维人员快速回滚或修复问题。
在灰度发布期间，建议暂时关闭 Nginx 的 keepalive 连接复用功能，以减少因长连接导致的请求误判。此外，可配合 max_fails 和 fail_timeout 参数，动态调整节点的可用性判断阈值。例如，设置 max_fails=1 fail_timeout=10s，使得节点在连续失败一次后，暂停服务 10 秒，避免短时间内大量请求涌入故障节点。
