Spring Cloud Gateway 微服务统一入口实战

启动类保持标准结构即可：

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

配置路由

在 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：断言条件，只有匹配该条件的请求才会被路由转发。

访问 http://127.0.0.1:10030/order/1 时，请求会被转发到 order-service。

路由断言工厂 (Route Predicate Factories)

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

默认提供了丰富的断言工厂，支持组合使用。例如，除了路径匹配，还可以限制时间范围：

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]

这意味着只有在指定时间之后的请求才能通过。更多内置断言可参考官方文档。

过滤器工厂 (Gateway Filter Factories)

Predicate 决定'去哪里'，Filter 决定'怎么处理'。过滤器分为 Pre（前置）和 Post（后置）类型，作用范围分为全局（Global）和局部（GatewayFilter）。

局部过滤器

局部过滤器仅对特定路由生效。比如在 product-service 路由下添加参数：

filters:
  - AddRequestParameter=userName,bite

这样所有进入 /product/** 的请求都会带上 userName=bite 参数。后端控制器接收时就能拿到这个值。

若希望对所有路由生效，可使用 default-filters 配置：

spring:
  cloud:
    gateway:
      default-filters:
        - AddResponseHeader=X-Response-Default-Red,Default-Blue

全局过滤器

全局过滤器作用于所有请求，常用于日志、监控或安全校验。Spring Cloud Gateway 内置了一些全局过滤器，如指标监控、负载均衡客户端等。

开启 Actuator 监控端点后，可以查看网关运行时的指标信息：

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

访问 http://127.0.0.1:10030/actuator 即可查看。

过滤器执行顺序

当项目中同时存在多种过滤器时，它们会被合并成一个过滤器链并按优先级排序。每个过滤器都有 order 值，数值越小优先级越高。

执行顺序大致遵循：defaultFilter > GatewayFilter > GlobalFilter。自定义过滤器时，建议通过 @Order 注解或实现 Ordered 接口明确指定优先级，避免逻辑冲突。

自定义过滤器

实际业务中，内置过滤器往往不够用，我们需要自定义逻辑。同样支持 GatewayFilterFactory 和 GlobalFilter 两种扩展方式。

自定义 GatewayFilter

继承 AbstractGatewayFilterFactory 即可。下面是一个示例，记录请求前后的日志：

@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;
    }
}

配合配置类 CustomConfig 和 YAML 配置使用：

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

自定义 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 为微服务架构提供了高性能的统一入口。通过合理配置路由断言和过滤器，我们可以灵活地实现鉴权、限流、日志追踪等横切关注点。在实际开发中，理解过滤器的执行顺序和自定义扩展机制，能帮助我们构建更健壮的系统。