Spring Cloud Gateway MVC 如何实现类似 Zuul ignored-patterns 的路由忽略功能？

我刚好碰到过和你一样的迁移痛点，原来Zuul的ignored-patterns用起来确实顺手，换到Spring Cloud Gateway MVC后，给你分享几个亲测有效的实现方式：

方案一：通过谓词排除特定路径 #

在网关路由里添加否定的Path谓词，把需要忽略的路径排除在转发路由之外，这样请求就会自动落到当前服务的本地端点上。

修改你的配置如下：

spring:
  cloud:
    gateway:
      mvc:
        routes:
          - id: gateway
            uri: http://localhost:8250
            predicates:
              - Path=/analytics-service/api/**
              - !Path=/analytics-service/api/user  # 排除该路径，不走网关转发
            filters:
              - StripPrefix=2

核心逻辑是利用谓词的“非”规则，让匹配/analytics-service/api/user的请求不进入这条转发路由，自然就由当前服务自己处理了。

方案二：添加优先级更高的本地转发路由 #

专门为需要忽略的路径创建一条指向本地的路由，并设置最高优先级，这样请求会先匹配这条本地路由，直接转发到当前服务自身，不走外部网关转发流程。

配置示例：

spring:
  cloud:
    gateway:
      mvc:
        routes:
          - id: local-user-endpoint
            uri: forward:/  # 直接转发到当前服务
            predicates:
              - Path=/analytics-service/api/user
            order: -1  # order值越小优先级越高，确保先匹配这条路由
          - id: gateway
            uri: http://localhost:8250
            predicates:
              - Path=/analytics-service/api/**
            filters:
              - StripPrefix=2

这里的forward:/是关键，它会把请求直接路由到当前服务的对应端点，完美模拟Zuul忽略后走本地的行为。

方案三：自定义过滤器实现灵活忽略逻辑 #

如果你的忽略规则比较复杂（比如要匹配多组路径、结合请求头/参数判断），可以写一个自定义Gateway过滤器，在过滤器里拦截指定路径并转发到本地。

示例代码如下：

@Component
public class IgnorePathLocalForwardFilter implements GatewayFilter {

    private static final String IGNORED_PATH = "/analytics-service/api/user";

    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        String requestPath = exchange.getRequest().getPath().value();
        if (IGNORED_PATH.equals(requestPath)) {
            // 调整请求路径，去掉网关前缀，适配本地端点
            String localPath = requestPath.replaceFirst("/analytics-service/api", "");
            ServerHttpRequest localRequest = exchange.getRequest().mutate()
                    .path(localPath)
                    .build();
            // 转发到本地服务
            return exchange.getDelegate().forward(localRequest);
        }
        // 非忽略路径，继续走网关转发逻辑
        return chain.filter(exchange);
    }
}

之后在网关路由配置里引入这个过滤器即可，这种方式适合需要自定义判断逻辑的复杂场景。

内容来源于stack exchange