RestTemplate调用接口报错：scheme名称索引0存在非法字符 求助

可能的原因及解决方法 #

1. URL字符串包含隐藏不可见字符 #

报错提示scheme名称（即URL开头的http部分）索引0存在非法字符，最常见的原因是你的baseUrl字符串开头混入了全角空格、BOM字节标记或其他不可打印的特殊字符——这些字符肉眼无法识别，但会导致URL解析失败。

解决方式：

• 手动重新输入baseUrl，避免复制粘贴引入隐藏字符；
• 用代码打印URL的每个字符编码，排查异常字符：

  for (char c : baseUrl.toCharArray()) {
      System.out.println((int) c + ": " + c);
  }
  

• 若URL来自配置文件，检查文件编码是否为UTF-8无BOM格式。

2. RequestEntity构建异常 #

GET请求通常不需要请求体，你传入的requestEntity如果构建不当，可能间接干扰URL解析逻辑。

解决方式：

• 临时替换调用代码，去掉requestEntity参数测试：

  ResponseEntity<List> responseEntity = restTemplate.exchange(baseUrl,
          HttpMethod.GET,
          null,
          List.class);
  

• 检查requestEntity的构建代码，确认未错误修改或附加URL相关内容。

3. RestTemplate自定义配置冲突 #

如果你的项目中自定义了RestTemplate的配置（比如自定义ClientHttpRequestFactory），可能修改了默认的URL解析逻辑，导致异常。

解决方式：

• 使用默认RestTemplate实例（不添加任何自定义配置）测试请求是否正常；
• 排查自定义配置中是否存在对URL进行错误编码、替换的逻辑。

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