RestTemplate调用带URL令牌接口返回401但Chrome访问正常

返回401的核心原因有2个，按影响概率排序：

• 多余的鉴权头触发服务端鉴权失败：你在代码里手动添加了Authorization: Bearer xxx请求头，同时如果你的RestTemplate配置了OAuth2全局请求拦截器，还会自动追加父接口的有效OAuth2令牌头。但根据接口规则，文件服务完全依赖URL上的查询参数做鉴权，根本不识别Bearer格式的鉴权头，收到这类不符合预期的鉴权信息时会直接返回401。对比Chrome成功的请求头可以发现，正常请求里完全没有Authorization字段。
• 参数拼接/解析错误：你手动拆分原URL的查询参数传递时，如果没有把原URL里的HTML转义字符&替换为标准参数分隔符&，或者baseUrl定义错误丢失了路径部分，会导致服务端拿不到完整的鉴权参数，也会返回401。

按以下步骤调整即可解决问题：

1. 移除手动添加的Authorization请求头，不要给文件服务请求加任何自定义鉴权字段。
2. 排查RestTemplate的拦截器配置：如果配置了全局OAuth2鉴权拦截器（即自动给所有请求追加Authorization头的逻辑），要么单独初始化一个不带任何拦截器的RestTemplate实例专门用于文件下载请求，要么修改拦截器逻辑，仅在请求业务服务域名时追加OAuth2头，请求文件服务域名时跳过鉴权头注入。
   常见的会导致问题的全局拦截器示例如下，这类逻辑必须排除文件服务地址：

   // 错误示例：全局拦截器会给所有出站请求加OAuth2头，污染文件服务请求
   restTemplate.getInterceptors().add((request, body, execution) -> {
       request.getHeaders().set("Authorization", "Bearer " + oauth2AccessToken);
       return execution.execute(request, body);
   });
   

3. 不要手动拆分拼接URL参数，直接使用父接口返回的完整文件URL发起请求即可，避免参数遗漏、转义错误。如果原返回的URL里带&这类HTML转义字符，先全局替换为&再使用。
   调整后的正确调用代码示例：

   // 直接使用父接口返回的、替换完转义字符的完整文件URL
   String fileUrl = "https://ep9.abc/v2/media/files/b9fe8e90?tokencreator=BFS&tokenexpires=1656712486&token=w8P3mbv";
   // 空请求头，不要加任何鉴权字段
   HttpEntity<Void> requestEntity = new HttpEntity<>(new HttpHeaders());
   // 发起请求，不需要额外传params参数，URL已经带全所有鉴权信息
   ResponseEntity<byte[]> zipFiles = restTemplate.exchange(
           fileUrl,
           HttpMethod.GET,
           requestEntity,
           byte[].class
   );
   

4. 校验方式：如果调整后仍报错，可以通过抓包工具对比RestTemplate发出的请求和Chrome成功请求的请求头、URL差异，删除所有Chrome请求里不存在的鉴权相关字段（比如多余的Cookie、Authorization头）即可。

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