Spring Cloud Gateway 微服务网关核心原理与实战

2.1.2 启动类配置

标准的 Spring Boot 启动类即可，无需特殊注解。

@SpringBootApplication
public class GatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }
}

2.1.3 路由配置

在 application.yml 中配置网关端口、服务名称及路由规则。这里以 Nacos 为注册中心为例：

server:
  port: 10030
spring:
  application:
    name: gateway
  cloud:
    nacos:
      discovery:
        server-addr: 110.41.51.65:10020
    gateway:
      routes:
        - id: product-service
          uri: lb://product-service
          predicates:
            - Path=/product/**
        - id: order-service
          uri: lb://order-service
          predicates:
            - Path=/order/**

配置说明：

• id：路由唯一标识。
• uri：目标服务地址，lb:// 表示从注册中心获取服务列表并进行负载均衡。
• predicates：断言条件，匹配 URL 路径前缀。

访问网关时，只需拼接路径即可，例如访问订单服务：http://127.0.0.1:10030/order/1。

2.2 路由断言工厂 (Route Predicate Factories)

Predicate 是 Java 8 的函数式接口，用于条件过滤。在 Gateway 中，它决定了请求是否匹配某个路由。

2.2.1 基础用法

默认提供了丰富的断言工厂，如 Path、After、Before 等。它们支持组合使用，例如同时限制路径和时间范围：

spring:
  cloud:
    gateway:
      routes:
        - id: product-service
          uri: lb://product-service
          predicates:
            - Path=/product/**
            - After=2026-01-01T00:00:00.000+08:00[Asia/Shanghai]

这意味着只有 2026 年之后的请求才能访问 /product/** 路径。这种灵活性使得我们可以轻松实现灰度发布或定时任务控制。

2.3 过滤器工厂 (Gateway Filter Factories)

Predicate 负责决定路由，而 Filter 负责在路由前后执行额外逻辑。Filter 分为 Pre（前置）和 Post（后置）两种类型。

2.3.1 局部过滤器 (GatewayFilter)

适用于特定路由。例如，只为 product-service 添加请求参数：

filters:
  - AddRequestParameter=userName, bite

这样，所有进入该路由的请求都会携带 userName=bite 参数。若需对所有路由生效，可使用 default-filters 配置全局默认过滤器。

2.3.2 全局过滤器 (GlobalFilter)\n作用于所有路由，常用于日志记录、监控指标或安全校验。Spring Cloud Gateway 内置了如 LoadBalancerClientFilter 等全局过滤器。

启用 Actuator 监控可观察内部过滤器链：

management:
  endpoints:
    web:
      exposure:
        include: "*"

访问 http://127.0.0.1:10030/actuator 即可查看网关运行状态。

2.4 过滤器执行顺序

当项目中同时存在 GatewayFilter 和 GlobalFilter 时，它们会被合并到一个过滤器链中排序执行。优先级由 order 值决定，数值越小优先级越高。

执行顺序遵循：defaultFilter > GatewayFilter > GlobalFilter。开发者可通过实现 Ordered 接口或添加 @Order 注解自定义优先级。

2.5 自定义过滤器

为了适配特定业务需求，我们可以扩展 Gateway 的过滤能力。

2.5.1 自定义 GatewayFilter

继承 AbstractGatewayFilterFactory 即可快速实现。注意 apply 方法中需返回一个 Mono<Void>，并在其中处理 Pre 和 Post 逻辑。

@Slf4j
@Service
public class CustomGatewayFilterFactory extends AbstractGatewayFilterFactory<CustomConfig> implements Ordered {
    public CustomGatewayFilterFactory() {
        super(CustomConfig.class);
    }

    @Override
    public GatewayFilter apply(CustomConfig config) {
        return ((exchange, chain) -> {
            log.info("[Pre] Filter Request, name: {}", config.getName());
            return chain.filter(exchange).then(Mono.fromRunnable(() -> {
                log.info("[Post] Response Filter");
            }));
        });
    }

    @Override
    public int getOrder() {
        return Ordered.LOWEST_PRECEDENCE;
    }
}

配合配置文件使用：

filters:
  - name: Custom
    args:
      name: custom filter

2.5.2 自定义 GlobalFilter

实现 GlobalFilter 接口即可，无需额外配置，会自动应用到所有请求。

@Slf4j
@Service
public class CustomGlobalFilter implements GlobalFilter, Ordered {
    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        log.info("[Pre] CustomGlobalFilter enter...");
        return chain.filter(exchange).then(Mono.fromRunnable(() -> {
            log.info("[Post] CustomGlobalFilter return...");
        }));
    }

    @Override
    public int getOrder() {
        return Ordered.LOWEST_PRECEDENCE;
    }
}

三、总结

Spring Cloud Gateway 凭借其高性能和灵活的扩展性，已成为微服务网关的首选方案。通过合理配置路由断言与过滤器，我们可以轻松构建统一的流量入口，实现鉴权、限流、监控等横切关注点。在实际开发中，建议优先使用内置过滤器，仅在必要时自定义，以保持系统的可维护性。