Spring Gateway带查询参数时URL重写错误（缺失/v1前缀）

现有路由配置 #

基于Spring Cloud Gateway搭建的微服务网关采用如下路由映射规则：

- id: advertisementService4
  uri: lb://advertisementService
  predicates:
    - Path=/public/breeds/**
  filters:
    - RewritePath=/public/breeds/(?<segment>/?.*), /v1/public/breeds/\${segment}

复现的异常现象 #

• 调用请求路径/public/breeds/500时，路由匹配正常，网关可正确将路径重写为/v1/public/breeds/500转发至目标服务
• 调用请求/public/breeds?petType=Dog时，路由断言虽成功匹配规则，但网关实际转发的路径为/public/breeds?petType=Dog，缺失预期的v1前缀，与重写规则预期不符

问题核心成因 #

异常与查询参数无直接关联，根源来自RewritePath过滤器的正则匹配范围存在遗漏：

1. 路由断言Path=/public/breeds/**遵循Spring PathPattern匹配逻辑，规则中的/**可匹配0个或多个路径段，因此无后续子路径的/public/breeds本身可被路由断言正常命中。
2. 现有RewritePath正则要求必须匹配/public/breeds/（即breeds路径段后必须紧跟斜杠）的结构才会触发重写。当请求路径为/public/breeds时，breeds后既无斜杠也无后续路径内容，正则完全不匹配，重写过滤器直接跳过执行，最终原封不动将/public/breeds路径转发给目标服务。
3. 容易将问题归因于查询参数，本质是因为带查询参数的请求刚好触发了“无后续路径段”的遗漏场景——就算不带任何查询参数直接请求/public/breeds，也会出现同样的缺失v1前缀的问题。

修复方案 #

调整RewritePath的正则匹配规则，将/public/breeds无斜杠、无后续路径的场景纳入匹配范围，调整后的配置为：

filters:
  - RewritePath=/public/breeds(?<segment>/?.*), /v1/public/breeds/\${segment}

调整后规则可覆盖全场景请求：

• 路径为/public/breeds时，捕获的segment值为空，重写结果为/v1/public/breeds
• 路径为/public/breeds/500时，捕获的segment值为/500，重写结果为/v1/public/breeds/500
• 所有查询参数会由网关自动透传，无需在重写规则中额外处理。

内容的提问来源于stack exchange，提问作者AleGallagher