RewritePath 过滤器

DeepSeek V3 中英对照 RewritePath Filter RewritePath Filter

RewritePath 过滤器接收一个路径 regexp 参数和一个 replacement 参数。它使用 Java 正则表达式来灵活地重写请求路径。以下配置展示了如何配置 RewritePath 过滤器：

spring:
  cloud:
    gateway:
      server:
        webmvc:
          routes:
            - id: rewritepath_route
              uri: https://example.org
              predicates:
              - Path=/red/**
              filters:
              - RewritePath=/red/?(?<segment>.*), /$\{segment}

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.rewritePath;
import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.uri;
import static org.springframework.cloud.gateway.server.mvc.handler.GatewayRouterFunctions.route;
import static org.springframework.cloud.gateway.server.mvc.handler.HandlerFunctions.http;

@Configuration
class RouteConfiguration {

    @Bean
    public RouterFunction<ServerResponse> gatewayRouterFunctionsRewritePath() {
        return route("rewritepath_route")
            .GET("/red/**", http())
            .before(uri("https://example.org"))
            .before(rewritePath("/red/(?<segment>.*)", "/${segment}"))
            .build();
    }
}

对于请求路径 /red/blue，这会在发起下游请求之前将路径设置为 /blue。请注意，在 application.yml 中，由于 YAML 规范的要求，$ 应替换为 $\。

注意

如果使用 lb() 过滤器，需要将其放在 rewritePath() 过滤器之后，否则生成的 URL 可能不正确。配置中的 lb: 方案处理程序会自动将该过滤器置于最高优先级顺序。