Java 8升级至Java 11后上传2MB以上文件抛出java.net.SocketException: Broken pipe

该问题是Java 8升级到Java 11后，JDK内置HTTP客户端的默认行为变更导致的，核心原因有两点：

• 分块传输默认触发阈值变更：Java 9及以上版本中，HttpURLConnection（RestTemplate默认使用的底层HTTP客户端）在请求体大小超过默认阈值（2MB，完全匹配你遇到的故障临界点）时，会自动启用分块传输编码，请求头会携带Transfer-Encoding: chunked而不是Content-Length。如果Documentum REST服务未兼容分块传输逻辑，会直接主动断开连接，导致客户端写入数据时抛出Broken pipe异常。这也是你手动调整Content-Length参数无效的核心原因，触发自动分块后手动设置的Content-Length会被JDK默认忽略。
• Keep-Alive默认超时时间缩短：Java 8中HTTP连接默认Keep-Alive超时为30秒，Java 11将该值下调为5秒。大文件上传如果耗时超过5秒，底层空闲连接会被JDK自动回收，导致传输中断。

你提到的手动添加Connection: keep-alive头没有必要，JDK默认已经开启HTTP长连接，该配置无法解决当前故障。

方案1：调整RestTemplate默认请求工厂配置（无额外依赖） #

调整SimpleClientHttpRequestFactory的参数，规避分块传输的自动触发，同时调整连接超时配置：

@Bean
public RestTemplate restTemplate() {
    SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
    // 设置分块阈值大于业务最大上传文件大小，避免触发分块传输
    requestFactory.setChunkSize(100 * 1024 * 1024); // 示例为100MB，可根据业务场景调整
    // 调整超时时间，避免超时导致连接提前断开
    requestFactory.setConnectTimeout(30000);
    requestFactory.setReadTimeout(120000); // 可根据最大文件上传耗时调整
    return new RestTemplate(requestFactory);
}

同时可在服务启动参数中添加JDK全局HTTP配置，延长长连接超时时间：

-Dhttp.keepAlive=true
-Dhttp.keepAlive.seconds=60
-Dhttp.maxConnections=20

方案2：替换底层为Apache HttpClient（长期稳定推荐） #

JDK自带的HttpURLConnection灵活性和兼容性较差，替换为Apache HttpClient可更精细控制传输行为，适配各类服务端的要求：

1. 引入Apache HttpClient依赖（Maven示例）：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.14</version>
</dependency>

2. 配置RestTemplate使用HttpClient作为底层实现：

@Bean
public RestTemplate restTemplate() {
    HttpClient httpClient = HttpClientBuilder.create()
            .setConnectionTimeToLive(60, TimeUnit.SECONDS)
            .evictIdleConnections(30, TimeUnit.SECONDS)
            .setMaxConnTotal(20)
            .setMaxConnPerRoute(10)
            .build();
    HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
    // 强制使用Content-Length，禁用分块传输
    requestFactory.setBufferRequestBody(true);
    // 配置超时参数
    requestFactory.setConnectTimeout(30000);
    requestFactory.setReadTimeout(120000);
    return new RestTemplate(requestFactory);
}

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