默认roundrobinloadbalancer不支持灰度发布，因其仅依据健康状态和注册顺序轮询，无视元数据、版本号及权重；需重写choose()方法提取请求头（如x-gray-tag）并匹配实例元数据，再结合weight实现加权随机路由。
为什么默认的 RoundRobinLoadBalancer 不适合灰度发布
因为它的选择逻辑只看实例健康状态和注册顺序，完全不感知元数据、版本号或权重配置。当你在 Nacos 里给实例打了 version=v2 和 weight=30，它照样轮询分发，不会把 30% 的流量导向 v2 实例。
真正起作用的是 ReactorServiceInstanceLoadBalancer 接口的实现类，而 Spring Cloud 默认只提供 RoundRobinLoadBalancer 和 RandomLoadBalancer 这两个基础实现 —— 它们不读请求头，也不查元数据，更不支持动态权重计算。
如何让 choose() 方法读取请求头并匹配元数据
关键在于重写 choose(Request request) 方法时，从 request 中提取上下文信息（比如 X-Gray-Tag 或 user-type），再遍历 ServiceInstance 列表做匹配。
- 用
RequestDataContext提取原始 HTTP 请求：如果是在网关或 Feign 调用中，request实际是DefaultRequest，其context字段可能包含ServerWebExchange或ClientRequest - 安全提取 header：不要直接强转，先用
Optional.ofNullable(request.getContext()).map(...)防 NPE - 元数据匹配建议用
instance.getMetadata().get("version")而非硬编码 key，避免不同服务字段不一致
示例片段：
String grayTag = Optional.ofNullable(request.getContext())
.map(ctx -> (ServerWebExchange) ctx)
.map(exchange -> exchange.getRequest().getHeaders().getFirst("X-Gray-Tag"))
.orElse(null);
<p>List<serviceinstance> candidates = instances.stream()
.filter(i -> Objects.equals(i.getMetadata().get("gray-tag"), grayTag))
.collect(Collectors.toList());
</serviceinstance></p>
如何实现基于 weight 字段的加权随机路由
单纯过滤出带指定标签的实例还不够 —— 灰度场景常需按比例分配流量，比如 v2 实例权重设为 20，v1 设为 80，整体按 2:8 分流。这需要把元数据中的 weight 解析为整数，并做加权随机选择。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
-
weight必须是正整数，且所有同服务实例的weight值之和应 > 0，否则 fallback 到 round-robin - 不要用
Math.random() * sum线性扫描，对实例数多的集群性能差；改用别名法（Alias Method）或预构建累积权重数组 + 二分查找 - 注意 Nacos/K8s 注册时
weight是字符串，需Integer.parseInt(metadata.get("weight"))并捕获NumberFormatException
简单可行的累积权重方案：
List<integer> weights = instances.stream()
.map(i -> Integer.parseInt(i.getMetadata().getOrDefault("weight", "1")))
.collect(Collectors.toList());
int total = weights.stream().mapToInt(Integer::intValue).sum();
int r = ThreadLocalRandom.current().nextInt(total);
int cursor = 0;
for (int i = 0; i <h3>为什么必须手动注册 ServiceInstanceListSupplier</h3>
<p>Spring Boot 自动装配的 <code>ServiceInstanceListSupplier</code> 默认只返回全量健康实例，不支持按元数据过滤。如果你只重写了 <code>ReactorServiceInstanceLoadBalancer</code>，但没替换掉上游的实例供给源，那 <code>choose()</code> 拿到的还是所有实例，过滤逻辑就白写了。</p>
<ul>
<li>必须声明一个 <code>@Bean</code> 类型为 <code>ServiceInstanceListSupplier</code>，且 <code>@ConditionalOnBean(ReactorServiceInstanceLoadBalancer.class)</code> 控制生效时机</li>
<li>推荐继承 <code>DiscoveryClientServiceInstanceListSupplier</code>，重写 <code>get() </code>方法，在返回前对 <code>ServiceInstance</code> 列表做预过滤（例如排除 <code>env=dev</code> 的本地实例）</li>
<li>若使用 Nacos，注意 <code>NacosServiceInstanceListSupplier</code> 默认不刷新元数据变更，需配合 <code>@Scheduled</code> 或监听 <code>com.alibaba.nacos.api.naming.listener.Event</code>
</li>
</ul>
<p>漏掉这步，你写的灰度逻辑永远只在“理论上”生效。</p>
<p>最易被忽略的是权重归一化与元数据一致性校验：不同服务可能把权重存在 <code>weight</code>、<code>traffic-weight</code> 或 <code>canary-ratio</code> 字段，而你的负载均衡器若只认一个 key，就会在部分服务上失效。上线前务必用真实 Nacos 实例跑一遍元数据 schema 校验。</p></integer>
