Kong中微服务路径被前端根路由匹配拦截问题如何解决

排查步骤 #

• 确认路由匹配类型：检查abc-microservice对应的路由Paths配置的匹配规则，若设置为精确匹配，只有请求路径完全等于/abc/swagger时才会命中，前缀匹配才能覆盖所有以该路径开头的请求。
• 确认请求方法限制：检查abc-microservice的路由是否限制了请求方法，若仅允许GET方法，PUT、POST请求会匹配失败，自动落到根路由。
• 确认host绑定配置：检查abc-microservice的路由是否绑定了特定Host，若你访问的www.xyz.com不在绑定的Host列表内，该路由不会被命中。
• 查看Kong日志确认匹配结果：执行命令tail -f /var/log/kong/access.log，日志中会打印每个请求命中的route_id和service_id，对比配置的ID确认是否匹配到错误路由。
• 排查全局/服务级插件：检查是否启用了request-transformer等路径重写类插件，错误的重写规则会导致路径被篡改后落到根路由。

解决方案 #

• 修正路由匹配规则：将abc-microservice的路由匹配规则改为前缀匹配，匹配路径配置为/abc/，所有以/abc/开头的请求都会优先命中该路由（Kong默认遵循最长路径优先匹配规则，/abc/优先级高于根路径/）。若只需覆盖swagger相关路径，可同时配置/abc/swagger、/abc/swagger/*两个前缀匹配路径。
• 放开所需请求方法：给abc-microservice的路由添加PUT、POST等所需的请求方法权限，避免方法不匹配导致路由命中失败。
• 手动调整路由优先级：如果仍出现匹配问题，可手动设置路由的Priority字段，数值越大优先级越高，将abc-microservice的路由Priority设为100，前端根路由的Priority设为10，确保微服务路由优先匹配。
• 验证配置生效：修改配置后执行kong reload重载配置，使用curl命令验证：

curl -X PUT -v https://www.xyz.com/abc/swagger

查看请求返回的响应头与后端服务日志，确认请求已正确转发到abc-microservice。

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