Spring Cloud Gateway路由URI属性失效问题排查与解决

问题原因 #

你的路由配置中，uri已经包含完整的后端服务路径http://localhost:5555/x-service/v1/private/files，但Path predicate匹配的是/v1/private/files。Spring Cloud Gateway默认会将匹配到的路径追加到uri的路径之后，导致实际转发地址变成http://localhost:5555/x-service/v1/private/files/v1/private/files。后端服务无法识别这个错误路径，因此返回重定向到/v1/private/files，引发你遇到的问题。

解决方法 #

提供两种可行的配置方案：

方案一：拆分uri与路径，使用StripPrefix过滤器 #

将uri缩短到服务根路径，通过Path predicate匹配完整路径，再用StripPrefix过滤器控制路径转发规则：

spring.cloud.gateway.routes[0].id=x-service
spring.cloud.gateway.routes[0].uri=http://localhost:5555/x-service
spring.cloud.gateway.routes[0].predicates[0]=Path=/v1/private/files/**
spring.cloud.gateway.routes[0].filters[0]=StripPrefix=0

这里StripPrefix=0表示不裁剪路径，请求/v1/private/files会直接转发到http://localhost:5555/x-service/v1/private/files，符合预期。

方案二：保留原uri，使用RewritePath过滤器 #

如果希望保留原uri的完整路径，添加RewritePath过滤器将匹配到的路径替换为空，避免重复追加：

spring.cloud.gateway.routes[0].id=x-service
spring.cloud.gateway.routes[0].uri=http://localhost:5555/x-service/v1/private/files
spring.cloud.gateway.routes[0].predicates[0]=Path=/v1/private/files/**
spring.cloud.gateway.routes[0].filters[0]=RewritePath=/v1/private/files/(?<segment>.*), /$\{segment}

该配置会将请求路径中/v1/private/files之后的部分（如果有的话）追加到uri后，无后续部分时直接转发到uri地址。

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