使用HttpsURLConnection发POST请求偶现unexpected end of stream错误如何解决？

现有代码问题排查 #

你提供的实现代码存在多个逻辑与时序错误，是偶发异常的核心诱因：

• 超时、connect()调用时序错误：getOutputStream()执行时已经隐含发起TCP连接、TLS握手流程，你在操作输出流之后才设置连接超时、读超时、主动调用connect()完全不生效，相当于没有配置超时限制，弱网场景下很容易出现连接被中间节点主动断开的问题。
• 重复设置同名请求头：连续两次调用setRequestProperty("type")，后设置的tRequestString会直接覆盖之前的car值，如果服务端依赖该参数做合法性校验，异常请求会被服务端主动断连。
• 未指定请求体编码：直接调用post_data.getBytes()会使用Android系统默认编码，和服务端要求的编码不一致时会导致请求体长度、内容异常，触发服务端主动断连。
• 缺失必要请求头：POST请求未显式设置Content-Type、Content-Length头，部分严格的服务端或反向代理会直接拒绝请求，主动关闭连接。

修复实现代码 #

HttpsURLConnection myConnection = null;
try {
    myConnection = (HttpsURLConnection) new URL(tURL).openConnection();
    myConnection.setRequestMethod("POST");
    // 所有配置、超时设置必须放在流操作之前
    myConnection.setConnectTimeout(10000); // 不建议设置100秒这么长的超时，10秒足够覆盖绝大多数场景
    myConnection.setReadTimeout(30000);
    myConnection.setDoOutput(true);
    
    // 请求头设置，修复重复type的问题，按需保留一个值即可
    myConnection.setRequestProperty("info", "ok");
    myConnection.setRequestProperty("type", tRequestString);
    // 显式声明请求体格式与编码，根据业务实际调整Content-Type值
    myConnection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded; charset=utf-8");
    // 提前计算请求体字节长度，设置Content-Length避免服务端识别异常
    byte[] postBody = post_data.getBytes("UTF-8");
    myConnection.setRequestProperty("Content-Length", String.valueOf(postBody.length));

    // 所有配置完成后再操作输出流，不需要手动调用connect()方法
    try (OutputStream outputStream = myConnection.getOutputStream()) {
        outputStream.write(postBody);
        outputStream.flush();
    }

    // 读取响应逻辑
    int responseCode = myConnection.getResponseCode();
    // 业务层响应处理...
} catch (IOException e) {
    // 异常捕获，幂等POST请求可在这里加重试逻辑
} finally {
    // 最终断开连接释放资源
    if (myConnection != null) {
        myConnection.disconnect();
    }
}

额外优化方案 #

如果修改代码逻辑后仍然偶发该异常，可以增加以下配置：

• 禁用连接复用：Android底层HttpsURLConnection基于OkHttp实现，长连接复用时如果拿到服务端已经提前关闭的连接就会触发该异常，可在初始化连接前添加配置关闭长连接复用：

System.setProperty("http.keepAlive", "false");

• 增加重试机制：确认你的POST请求是幂等的（重复提交不会产生脏数据）的前提下，捕获到该异常时自动重试1~2次，即可覆盖绝大多数偶发的网络波动、连接复用异常场景。
• 对齐服务端配置：如果可以协调服务端团队，确认服务端的长连接保持时间是否短于客户端默认值，对齐超时规则即可彻底解决连接复用异常问题。

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