Spring Boot项目向第三方传文件遇Content-Transfer-Encoding弃用报错求助

这个错误的核心原因是：RFC7578在2015年弃用了Content-Transfer-Encoding头，而你的Spring Boot项目在发送multipart文件请求时，底层组件自动添加了这个头，导致严格遵循规范的第三方服务拒绝请求。以下是针对Spring Boot 2.2.0（Java 1.8）的具体解决方法：

方法一：手动构建Multipart请求并移除违规头 #

如果使用RestTemplate发送文件上传请求，可通过MultipartBodyBuilder手动控制请求头，移除自动生成的Content-Transfer-Encoding：

// 初始化RestTemplate
RestTemplate restTemplate = new RestTemplate();

// 构建multipart请求体
MultipartBodyBuilder bodyBuilder = new MultipartBodyBuilder();
bodyBuilder.part("file", new FileSystemResource("/path/to/your/file"))
           .headers(headers -> {
               // 移除自动添加的Content-Transfer-Encoding头
               headers.remove("Content-Transfer-Encoding");
               // 按需设置文件对应的Content-Type，比如图片用image/jpeg
               headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
           });

// 封装请求实体
HttpEntity<MultiValueMap<String, HttpEntity<?>>> requestEntity = 
       new HttpEntity<>(bodyBuilder.build(), new HttpHeaders());

// 发送POST请求到第三方服务
String response = restTemplate.postForObject("https://third-party-upload-url", requestEntity, String.class);

方法二：通过HttpClient拦截器全局移除违规头 #

如果项目中多处使用文件上传，可配置RestTemplate的底层HttpClient拦截器，全局移除Content-Transfer-Encoding头：

@Bean
public RestTemplate customRestTemplate() {
    // 创建HttpClient并添加请求拦截器
    CloseableHttpClient httpClient = HttpClientBuilder.create()
            .addInterceptorFirst((HttpRequestInterceptor) (request, context) -> {
                // 移除请求中的Content-Transfer-Encoding头
                request.removeHeaders("Content-Transfer-Encoding");
            })
            .build();

    // 配置RestTemplate使用自定义HttpClient
    HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
    return new RestTemplate(requestFactory);
}

方法三：处理本地文件上传时的请求头（如果是接收上传后转发） #

如果你的项目是先接收前端文件上传，再转发到第三方服务，可在获取MultipartFile后手动构建请求时跳过Content-Transfer-Encoding头：

@PostMapping("/upload")
public String forwardFile(@RequestParam("file") MultipartFile file) throws IOException {
    RestTemplate restTemplate = new RestTemplate();
    MultipartBodyBuilder builder = new MultipartBodyBuilder();
    builder.part("file", file.getInputStream())
           .headers(headers -> {
               headers.remove("Content-Transfer-Encoding");
               headers.setContentType(MediaType.parseMediaType(file.getContentType()));
               headers.setContentLength(file.getSize());
           });
    HttpEntity<MultiValueMap<String, HttpEntity<?>>> request = new HttpEntity<>(builder.build());
    return restTemplate.postForObject("third-party-url", request, String.class);
}

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