基于Spring Cloud Gateway实现灰度发布的具体配置示例_Java

基于 spring cloud gateway 实现灰度发布，核心思路是通过定义路由规则，将特定流量导向新版本服务。下面我用一个表格汇总主要策略，然后提供具体配置示例和关键说明。

灰度发布策略概览

策略类型	核心机制	适用场景
基于请求头 (header)	检查请求头中的特定标识（如 x-gray-release: true）	内部测试、指定体验用户
基于权重 (weight)	按配置的百分比随机分配流量到不同版本	a/b测试、逐步放量
基于用户标识/ip	根据用户id、cookie或ip地址等条件进行匹配	定向灰度（如特定员工、地区用户）

具体配置示例

1. 基于请求头的灰度路由

此方式常用于内部测试人员或通过特定标识触发灰度环境。

spring:
  cloud:
    gateway:
      routes:
        # 灰度路由（高优先级）
        - id: user-service-gray
          uri: lb://user-service
          predicates:
            - path=/api/user/**
            - header=x-gray-release, true # 当请求头包含 x-gray-release: true 时匹配
          filters:
            - addrequestheader=x-request-version, v2 # 可为下游服务添加标识
          order: 0 # 优先级高于默认路由
        # 默认路由（兜底）
        - id: user-service-default
          uri: lb://user-service
          predicates:
            - path=/api/user/**
          order: 1

说明：请求时携带 header x-gray-release: true的请求会被路由到灰度服务实例。

2. 基于权重的灰度路由

适用于随机分配一定比例的流量到新版本，实现金丝雀发布。

spring:
  cloud:
    gateway:
      routes:
        - id: weight_high
          uri: lb://user-service-v1
          predicates:
            - path=/api/order/**
            - weight=user-service-group, 80 # 80%流量到v1
        - id: weight_low
          uri: lb://user-service-v2
          predicates:
            - path=/api/order/**
            - weight=user-service-group, 20 # 20%流量到v2

说明：同一个组（user-service-group）的权重总和应为100。gateway 会根据权重随机转发请求。

3. 基于用户id或ip的灰度路由

可以实现更精细的流量控制，例如让用户id尾号为0的用户访问新版本。

a) 通过自定义全局过滤器实现

@component
@order(-1)
public class grayuserfilter implements globalfilter {
    // 假设这是灰度用户名单
    private final set<string> grayusers = set.of("1001", "1002", "1005"); 
    @override
    public mono<void> filter(serverwebexchange exchange, gatewayfilterchain chain) {
        string userid = exchange.getrequest().getheaders().getfirst("x-user-id");
        if (grayusers.contains(userid)) {
            // 将用户标记为灰度用户，后续可通过自定义断言路由
            exchange.getattributes().put("gray_tag", true);
        }
        return chain.filter(exchange);
    }
}

说明：此过滤器检查请求头中的 x-user-id，若id在灰度名单内，则为其打上标签。

b) 配置路由规则使用该标签

可结合自定义的 routepredicatefactory来路由标记了 gray_tag的请求到新版本服务。

关键实现要点

服务实例标识：确保新版本服务在注册到nacos或eureka时带有元数据（metadata）标识，如 version: v2。
全链路标签透传：为了让灰度标识在后续微服务调用链中持续生效，需要在gateway的过滤器中将其添加到请求头，并配置openfeign拦截器继续传递该头信息。
动态配置更新：结合spring cloud config或nacos等配置中心，可以动态调整灰度规则（如权重值、灰度用户列表），无需重启网关即可生效。