Spring 6+JDK17+Apache HttpClient5环境下RestTemplate设置HttpComponentsClientHttpRequestFactory后GET请求报400错误

遇到这个问题我太熟悉了！之前升级Spring 6和HttpClient5的时候也踩过类似的坑，咱们一步步来分析和解决：

问题根源 #

Spring 6对Apache HttpClient5的适配逻辑，和Spring5对HttpClient4的适配有不少差异，尤其是GET请求的参数编码、请求头默认处理这两块——默认的SimpleClientHttpRequestFactory（RestTemplate默认使用的工厂）会自动帮我们处理一些细节，而HttpComponentsClientHttpRequestFactory在HttpClient5下的默认行为更严格，就导致了GET请求报错、POST正常的情况。

具体解决方案 #

1. 确保GET请求参数被正确编码

如果你的GET请求是直接拼接参数到URL后面，很可能因为HttpClient5对URL编码的规则更严格，特殊字符（比如空格、&、=等）没有被正确转义，触发服务端的400错误。建议用UriComponentsBuilder来构建带参数的URL，它会自动帮我们编码参数：

// 示例：构建带参数的编码URL
UriComponents uri = UriComponentsBuilder.fromHttpUrl("http://你的服务地址")
        .queryParam("param1", "需要编码的值")
        .queryParam("param2", "带空格的参数")
        .build(true); // true表示强制编码参数

// 用这个编码后的URL发起请求
ResponseEntity<String> response = restTemplate.exchange(uri.toUriString(), HttpMethod.GET, null, String.class);

2. 正确配置HttpComponentsClientHttpRequestFactory

直接用无参构造创建HttpComponentsClientHttpRequestFactory时，HttpClient5的默认配置可能不符合你的需求，建议手动创建HttpClient实例并配置参数后传入工厂：

// 自定义HttpClient配置，比如超时、连接池等
CloseableHttpClient httpClient = HttpClients.custom()
        .setDefaultRequestConfig(RequestConfig.custom()
                .setConnectTimeout(5000) // 连接超时
                .setConnectionRequestTimeout(5000) // 连接池获取连接超时
                .setSocketTimeout(5000) // 响应超时
                .build())
        .build();

// 创建工厂并传入自定义HttpClient
HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
RestTemplate restTemplate = new RestTemplate(requestFactory);

3. 检查并补充必要的请求头

默认的SimpleClientHttpRequestFactory会自动添加一些请求头，但HttpComponentsClientHttpRequestFactory不会。有些服务对GET请求的请求头有要求（比如Content-Type），可以手动设置：

HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED); // 根据服务要求调整
HttpEntity<Void> entity = new HttpEntity<>(headers);

// 带请求头发起GET请求
ResponseEntity<String> response = restTemplate.exchange("http://你的服务地址", HttpMethod.GET, entity, String.class);

4. 开启日志排查细节

如果以上方法还没解决问题，建议开启详细日志，对比默认RestTemplate和设置工厂后的请求差异（比如URL、参数、请求头），定位具体错误：
在application.properties中添加日志配置：

logging.level.org.springframework.web.client.RestTemplate=DEBUG
logging.level.org.apache.http=DEBUG

通过日志可以看到请求的完整内容，比如参数是否被正确传递、URL是否有编码错误，快速找到问题所在。

备注：内容来源于stack exchange，提问作者vikas