本文详解如何在 Apache HttpClient 中正确构造并发送内容为空、媒体类型为 application/octet-stream 的二进制 POST 请求，替代 cURL 的 --data-binary {} 行为，并提供可直接运行的代码示例与关键注意事项。
本文详解如何在 apache httpclient 中正确构造并发送内容为空、媒体类型为 `application/octet-stream` 的二进制 post 请求，替代 curl 的 `--data-binary {}` 行为，并提供可直接运行的代码示例与关键注意事项。
在使用 Java 实现与 cURL 等效的 HTTP 请求时，一个常见误区是混淆“空 JSON 字符串”（如 "{}"）与“空二进制载荷”。题中 curl -X POST --data-binary {} 并非发送 JSON 对象，而是以原始二进制模式发送长度为 0 的字节流——即请求体（body）完全为空（Content-Length: 0），但显式声明了二进制语义（Content-Type: application/octet-stream）。这与 StringEntity("{}", "UTF-8") 有本质区别：后者会发送两个字节 {} 并默认设置 Content-Type: text/plain 或 application/json，不符合二进制协议契约。
要精准复现 --data-binary {} 的行为，核心在于两点：
✅ 使用 InputStreamEntity 包装一个真正空的输入流（而非空字符串或空字节数组）；
✅ 显式设置 Content-Type: application/octet-stream（不可依赖默认值，因某些服务器严格校验 MIME 类型）。
以下是推荐的实现方式（基于 Apache HttpClient 4.5+ 和 Apache Commons IO）：
import org.apache.commons.io.IOUtils;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.InputStreamEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import java.io.IOException;
public class EmptyBinaryPostExample {
public static void sendEmptyBinaryPost(String url) throws IOException {
try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
HttpPost httpPost = new HttpPost(url);
// ✅ 关键：设置二进制内容类型
httpPost.setHeader("Content-Type", "application/octet-stream");
// 可选：添加其他必要头（如认证、Accept）
httpPost.setHeader("Authorization", "Bearer your-api-token");
httpPost.setHeader("Accept", "application/json");
// ✅ 关键：使用空 InputStream 构造 InputStreamEntity
// IOUtils.toInputStream("") 返回一个读取零字节后即 EOF 的流
InputStreamEntity entity = new InputStreamEntity(
IOUtils.toInputStream("", "UTF-8"),
ContentType.APPLICATION_OCTET_STREAM
);
httpPost.setEntity(entity);
try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
System.out.println("Status: " + response.getStatusLine().getStatusCode());
// 处理响应...
}
}
}
// 使用示例
public static void main(String[] args) throws IOException {
sendEmptyBinaryPost("https://api.example.com/v1/endpoint");
}
}⚠️ 重要注意事项：
第一步】：将安装包中所有的文件夹和文件用ftp工具以二进制方式上传至服务器空间;(如果您不知如何设置ftp工具的二进制方式，可以查看：(http://www.shopex.cn/support/qa/setup.help.717.html)【第二步】：在浏览器中输入 http://您的商店域名/install 进行安装界面进行安装即可。【第二步】：登录后台，工具箱里恢复数据管理后台是url/sho
- 不要使用 ByteArrayEntity(new byte[0])：它虽生成空字节数组，但默认 ContentType 为 application/octet-stream，看似可行，实则存在风险——部分 HTTP 客户端（如旧版 HttpClient）可能对空数组做特殊处理，或服务端解析异常；而 InputStreamEntity 是更标准、更明确的二进制流抽象。
- 避免 StringEntity("")：它会设置 text/plain 类型，且可能触发字符编码头（如 charset=UTF-8），违反二进制协议要求。
- 依赖项检查：确保项目包含 org.apache.httpcomponents:httpclient（≥4.5）和 commons-io:commons-io（≥2.11）。若无法引入 Commons IO，可用 new ByteArrayInputStream(new byte[0]) 替代 IOUtils.toInputStream("")，效果等价。
- 服务端兼容性：确认目标 API 确实接受 Content-Length: 0 + application/octet-stream 组合；少数框架（如早期 Spring MVC）可能对空二进制体处理不严谨，此时需查阅文档或改用 @RequestBody byte[] 显式接收。
总结而言，发送空二进制数据的本质是显式声明二进制语义 + 提供零长度有效载荷流。采用 InputStreamEntity 配合 application/octet-stream 是最符合 HTTP 协议规范、服务端兼容性最佳、且语义最清晰的方案。
立即学习“Java免费学习笔记（深入）”；
