Spring Cloud Gateway 统一服务入口实战

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

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

2. 路由配置

在 application.yml 中配置网关端口及路由规则。这里假设 Nacos 地址为 nacos-server-address:8848（请替换为实际地址）。

server:
  port: 10030

spring:
  application:
    name: gateway
  cloud:
    nacos:
      discovery:
        server-addr: nacos-server-address:8848
    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 会被转发至订单服务。

路由断言工厂 (Route Predicate Factories)

理解 Predicate

Predicate 是 Java 8 的函数式接口，接收参数返回布尔值，用于条件判断。在网关中，它决定了请求是否匹配某个路由。

@FunctionalInterface
public interface Predicate<T> {
    boolean test(T t);
}

例如，我们可以定义一个检查字符串是否为空的 Predicate：

Predicate<String> isEmpty = s -> s.isEmpty();
System.out.println(isEmpty.test("")); // true

网关中的断言

在配置文件中看到的 Path=/product/** 只是字符串形式，Spring Cloud Gateway 会通过 Route Predicate Factory 将其解析为具体的匹配逻辑。默认提供了丰富的断言类型，支持 HTTP 请求的不同属性匹配，并可通过 and 组合多个条件。

更多内置断言可参考官方文档。

实战演示

除了路径匹配，还可以结合时间断言限制访问窗口：

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 则决定请求如何处理。Filter 分为 Pre（前置）和 Post（后置）两种类型，分别在请求转发前和响应返回前执行。

GatewayFilter vs GlobalFilter

• GatewayFilter：作用于单个或一组特定路由，在配置文件中针对具体路由添加。
• GlobalFilter：作用于所有路由，全局生效，常用于日志、监控、全局鉴权等。

GatewayFilter 使用

以添加请求参数为例，只需在路由配置中添加 filters 节点：

filters:
  - AddRequestParameter=userName,bite

这会在转发给 product-service 的请求头中追加 userName=bite 参数。若需对所有路由生效，可使用 default-filters 配置。

GlobalFilter 使用

全局过滤器通常配合 Actuator 使用，开启监控指标：

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

访问 /actuator 即可查看网关运行状态。

过滤器执行顺序

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

执行顺序遵循：defaultFilter > GatewayFilter > GlobalFilter（当 order 值相同时）。开发者可通过实现 Ordered 接口或添加 @Order 注解来定制优先级。

自定义过滤器

Spring Cloud Gateway 允许开发者扩展功能，自定义过滤器同样支持 GatewayFilter 和 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;
    }
}

配套配置类：

@Data
public class CustomConfig {
    private String name;
}

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

通过以上步骤，你可以灵活地构建符合业务需求的网关层，确保微服务系统的安全与稳定。