Spring cloud gateway设置context-path服务路由404排查过程
一、背景
最近做网关重构
技术选型为spring cloud gateway
采用consul作为配置中心和注册中心
秉承不重启原则,网关内部实现动态路由机制
采用定时任务定时更新网关路由信息
二、服务信息
- 微服务网关:spring-cloud-gateway
- 微服务:order-service、user-service
三、问题描述
因为网关服务集成了knife4j
因此可以通过访问http://网关ip:port/doc.html
即可访问所有在同一个注册中心的服务的knife4j信息
但是实际访问时用户服务相关接口报404错误
四、问题排查
1、排查发现order-service未设置server.servlet.context-path,user-service有设置;
2、验证context-path的影响发现在路由设置时path字段值必须加前缀再截取才可以正常路由;
3、由于公司网关是既有产品,当前是技术框架重构,因此不能改动原来接口访问路径,因此不可以在原有路径前面再加前缀;
排查源码发现请求会经过
- FilteringWebHandler的filter方法,此方法在路由过程中会走12个过滤器,其中第5个过滤器
- RewritePathGatewayFilterFactory中的apply方法会匹配服务启动时加载的regexp正则,从而对服务path进行改写。
源码如下:

五、解决方案
1)若配置路由URI为lb,则注册中心服务名称不能和server.servlet.context-path名称一致,否则contextPath会被改写为空字符串;
2)若注册中心和server.servlet.context-path必须一致,则断言中设置Path时需在contextPath前包装一层前缀,且Filter中需截取第一个字符串;
3)禁止gateway网关主动从consul拉取路由信息并设置默认过滤器,该操作会设置默认过滤规则,reWritePath匹配正则修改请求路径
- 在启动类添加注解:
@SpringBootApplication( exclude = org.springframework.cloud.gateway.discovery.GatewayDiscoveryClientAutoConfiguration.class)
4)推荐使用
- 重写过滤链(只需添加如下配置):
spring.cloud.gateway.discovery.locator.filters[0]=PreserveHostHeader
总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。
相关文章
SpringBoot读取properties配置文件中的数据的三种方法
本文主要介绍了SpringBoot读取properties配置文件中的数据的三种方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧2024-06-06
Java17中record替代Lombok部分功能使用场景探究
这篇文章主要介绍了使用Java17中的record替代Lombok的部分功能,本文来为大家小小的总结下,我们可以在哪些地方,利用record来替换Lombok2024-01-01


最新评论