You need to enable JavaScript to run this app. 经Spring Cloud Gateway携带JWT调用资源服务器返回HTTP 403的问题
优惠活动
大模型
产品
解决方案
定价
更多

经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。
分步修复
  1. 修正路由的路径重写规则,替换掉当前错误的路由配置:
    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=
    
  2. 开启Gateway的DEBUG日志,验证实际转发路径:
    加入配置logging.level.org.springframework.cloud.gateway=DEBUG,重启后发送一次代理请求,查看日志中打印的目标转发URL,确认和你直连测试的200接口路径完全一致。
  3. 校验转发的凭证一致性:
    在网关加临时的全局过滤器,打印转发请求携带的Authorization头,确认和你直连测试时使用的JWT完全一致,没有被其他过滤器(CORS处理器、自定义请求头组件)覆盖、修改格式。
  4. 交叉验证根因:
    拿着你直连用的有效JWT,直接请求资源服务器上那个错误的拼接路径(比如http://localhost:8081/v1/artists/api/artists),如果同样返回403,就可以100%确认是路径拼接错误导致的问题,和JWT权限无关。
常见误区
  • 路由URI中带的路径不是路径替换规则,只是转发路径的固定前缀。
  • 403不代表JWT权限不足:Spring Security的授权校验优先级高于业务接口存在性校验,只要路径不匹配授权规则的允许范围,哪怕接口不存在也会返回403。
  • TokenRelay不是透传原始请求的Authorization头:只要网关自身存在安全上下文,就会优先使用安全上下文里的凭证转发,原始请求头里的token会被覆盖。

内容的提问来源于stack exchange,提问作者jndietz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 10:54:05