经Spring Cloud Gateway携带JWT调用资源服务器返回HTTP 403的问题
根因定位
直连资源服务器返回200、经网关代理返回403,绝大多数场景和JWT权限无关,核心是Spring Cloud Gateway的两个默认行为和你的预期不一致:
- 路径拼接逻辑和预期不符:Spring Cloud Gateway不会把路由URI中写的路径段自动替换原请求的路径,只会将路由URI的路径作为转发路径的前缀,和原请求的剩余路径做拼接。按你现在的配置,请求
/api/artists实际会被转发到http://localhost:8081/v1/artists/api/artists,而非你预期的http://localhost:8081/v1/artists。这个路径根本不在资源服务器的业务接口范围内,触发了Spring Security的默认拒绝规则,直接返回403(授权校验在业务接口匹配前执行,所以不会返回404)。 - TokenRelay的凭证传递行为偏差:TokenRelay过滤器优先传递网关自身安全上下文中的认证凭证,而非客户端原始携带的JWT。如果网关配置了OAuth2客户端登录模式,转发出去的凭证会被替换成网关自己获取的access_token,哪怕客户端原始JWT权限足够,也会因为凭证不一致触发403。
分步修复
- 修正路由的路径重写规则,替换掉当前错误的路由配置:
spring: cloud: gateway: routes: - id: experience-api # 路由URI不要带业务路径,只写服务根地址 uri: http://localhost:8081 predicates: - Path=/api/artists/** filters: # 把请求路径中的/api前缀替换为/v1,实现/api/artists -> /v1/artists的映射 - RewritePath=/api/(?<remaining>.*), /v1/$\{remaining} - TokenRelay= - 开启Gateway的DEBUG日志,验证实际转发路径:
加入配置logging.level.org.springframework.cloud.gateway=DEBUG,重启后发送一次代理请求,查看日志中打印的目标转发URL,确认和你直连测试的200接口路径完全一致。 - 校验转发的凭证一致性:
在网关加临时的全局过滤器,打印转发请求携带的Authorization头,确认和你直连测试时使用的JWT完全一致,没有被其他过滤器(CORS处理器、自定义请求头组件)覆盖、修改格式。 - 交叉验证根因:
拿着你直连用的有效JWT,直接请求资源服务器上那个错误的拼接路径(比如http://localhost:8081/v1/artists/api/artists),如果同样返回403,就可以100%确认是路径拼接错误导致的问题,和JWT权限无关。
常见误区
- 路由URI中带的路径不是路径替换规则,只是转发路径的固定前缀。
- 403不代表JWT权限不足:Spring Security的授权校验优先级高于业务接口存在性校验,只要路径不匹配授权规则的允许范围,哪怕接口不存在也会返回403。
- TokenRelay不是透传原始请求的Authorization头:只要网关自身存在安全上下文,就会优先使用安全上下文里的凭证转发,原始请求头里的token会被覆盖。
内容的提问来源于stack exchange,提问作者jndietz
相关产品推荐
相关产品推荐

