部署Zip文件至Artifactory遇损坏问题：httpclient等工具失效Postman正常

核心排查点 #

• 禁止用字符流处理二进制文件：Zip是二进制格式，若用字符流（比如转成String再发送）会直接破坏文件结构。所有HTTP客户端必须直接用字节流/文件对象发送：
  • HttpClient：使用FileEntity或InputStreamEntity，绝对不能用StringEntity；
  • OkHttp：直接传入File对象构造RequestBody，避免任何字符串转换操作；
  • Rest Assured：用body(new File("xxx.zip"))或正确配置multiPart，确保是纯二进制传输。
• 检查Content-Type请求头：必须设置为application/zip，如果误设为文本类型（比如text/plain），服务器会对内容做编码转换，导致文件损坏。Postman会自动识别文件类型设置正确的头，你代码里大概率漏了这个配置。
• 确保流完整读取并正确关闭：发送文件时不要提前关闭文件流，也不能截断读取。比如用HttpClient时，要保证InputStreamEntity的内容被完整发送，避免中途抛出异常导致流未处理完毕。
• 排除额外压缩操作：检查代码里有没有误把Zip文件再次压缩，或者用GZIP流处理它，这会直接破坏Zip的内部结构。

正确代码示例（OkHttp） #

File zipFile = new File("/path/to/your/target.zip");
// 构造二进制请求体
RequestBody requestBody = new MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("file", zipFile.getName(),
                RequestBody.create(MediaType.parse("application/zip"), zipFile))
        .build();

Request request = new Request.Builder()
        .url("https://your-artifactory-domain/api/storage/your-repo/target-path")
        .addHeader("Authorization", "Bearer your-access-token")
        .post(requestBody)
        .build();

try (Response response = new OkHttpClient().newCall(request).execute()) {
    if (!response.isSuccessful()) throw new IOException("请求失败: " + response);
}

快速验证方法 #

用Postman的代码生成功能（右上角的</>按钮），生成你使用的工具（HttpClient/OkHttp/Rest Assured）的代码，和自己的代码逐行对比，重点看请求头、请求体构造方式的差异，基本能直接定位问题。

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