在 Nacos 中配置实例权重可以影响客户端负载均衡的流量分配概率，但仅靠权重无法实现基于请求特征（如 Header、User ID）的严格灰度路由，适合用于按比例分流场景。

核心原理与限制

Nacos 服务端负责存储实例元数据（包含 weight 字段），但不直接处理业务流量。流量控制逻辑实际发生在客户端的负载均衡器中。

当客户端拉取服务列表后，负载均衡器根据权重计算选择概率。需注意以下两点限制：

1. 概率而非规则：权重代表期望概率，短时间内流量分布可能存在波动，无法保证严格的 1:9 比例。
2. 客户端依赖：如果客户端负载均衡器未启用权重感知（例如使用了默认轮询），Nacos 控制台修改权重不会生效。

配置实例权重（实操）

主流 Spring Cloud Alibaba 版本中，application.yml 直接配置 weight 属性可能无效，建议采用以下两种可靠方式：

1. 控制台修改（推荐）

适用于静态配置或发布阶段调整：

1. 登录 Nacos 控制台 -> 服务管理 -> 服务列表。
2. 点击目标服务 -> 实例列表。
3. 点击实例右侧“编辑”，修改权重值（默认 1.0）。
4. 灰度策略：新版本实例权重调低（如 0.1），旧版本保持默认（1.0），观察流量后再逐步调整。

2. 代码动态注册（高级）

适用于需要运行时动态调整权重的场景，通过 NamingService API 注册：

import com.alibaba.nacos.api.naming.NamingService;\nimport com.alibaba.nacos.api.naming.NamingFactory;\nimport java.util.Properties;\n\npublic class NacosWeightConfig {\n    public void registerInstance() throws Exception {\n        Properties properties = new Properties();\n        properties.put("serverAddr", "127.0.0.1:8848");\n        properties.put("namespace", "public");\n        \n        NamingService namingService = NamingFactory.createNamingService(properties);\n        \n        // 注册实例时指定权重 weight=0.1\n        namingService.registerInstance("service-name", "192.168.1.100", 8080, "DEFAULT_GROUP", 0.1);\n    }\n}

注意：通过代码注册权重后，仍需确保客户端负载均衡器能识别该元数据。

客户端负载均衡配置

消费端必须使用支持权重的负载均衡器。在 Spring Cloud Alibaba 体系中，需确认依赖和配置：

1. 依赖检查：确保引入 spring-cloud-starter-alibaba-nacos-discovery，该依赖通常包含适配 Nacos 权重的 NacosLoadBalancer。
2. 策略确认：较新版本 Spring Cloud LoadBalancer 默认可能不感知 Nacos 权重。若发现权重不生效，可尝试显式配置负载均衡器类型或检查 SC Alibaba 版本说明。
3. 配置示例：部分版本需在消费端配置开启权重感知（视具体版本而定，若无特定配置项则默认依赖 SDK 实现）。

# 消费端 application.yml 示例（视版本而定）\nspring:\n  cloud:\n    loadbalancer:\n      # 确认是否支持 nacos 权重策略配置\n      enabled: true

流量验证脚本

权重配置完成后，需通过实际流量验证分布情况。以下 Shell 脚本可用于快速统计：

#!/bin/bash\n\n# 配置目标服务地址\nURL="http://localhost:8080/api/version"\nCOUNT=100\n\necho "开始发送 ${COUNT} 次请求..."\n\n# 循环请求并统计\nfor ((i=1; i<=${COUNT}; i++)); do\n    curl -s ${URL} >> access.log\ndone\n\necho "请求完成，统计结果："\n# 假设返回内容包含版本标识，如 v1 或 v2\nsort access.log | uniq -c | sort -rn

执行后观察终端输出，计算不同版本实例接收到的请求比例是否与权重设置大致吻合。注意短期波动属于正常现象。

常见风险与排查

• 权重≠路由规则：权重只能控制概率，无法实现“特定用户访问新版本”的精确灰度。精确灰度需配合网关 Header 路由或元数据路由。
• 客户端缓存延迟：Nacos 客户端有服务列表缓存，修改权重后，消费端可能需要秒级时间感知变化，非实时生效。可通过刷新缓存或重启消费端验证。
• 健康检查影响：若实例健康检查失败，实例可能被剔除，此时权重配置失效，流量会全部切到剩余健康实例。务必确保新版本实例健康状态正常。
• 流量瞬间倾斜：调整权重时避免大幅跳变（如从 0 直接到 100）。建议采用平滑调整策略（0 -> 10 -> 50 -> 100），并配合监控观察错误率。
• 版本兼容性：不同版本的 Nacos Client 对权重元数据的解析可能存在差异，升级前需查阅对应版本的发布说明。

参考来源

• Nacos 官方文档，服务注册与发现相关章节，URL: https://nacos.io/zh-cn/docs/
• Spring Cloud Alibaba 官方文档，Nacos Discovery 部分，URL: https://spring-cloud-alibaba-group.github.io/github-docs/