用 HttpClient 发送 XML POST 请求应优先采用纯 XML 请求体方式，设置 Content-Type 为 application/xml（UTF-8 编码），避免误用 multipart；仅当服务端明确要求 form-data 时才引入 httpmime 构建文件字段，且需严格匹配字段名与编码。
用 HttpClient 发送 XML 文件的 POST 请求，核心是设置正确的 Content-Type 和请求体
Java 的 HttpClient（尤其是 5.x 版本）不直接支持“上传文件”这种高层语义，它只管发 HTTP 请求。所谓“上传 XML 文件”，本质是构造一个 POST 请求，把 XML 内容作为请求体发送，并显式指定 Content-Type: application/xml（或 text/xml）。别被“上传”二字误导——除非你走 multipart/form-data 表单提交路径，否则不需要模拟文件字段、边界符或 Content-Disposition。
HttpClient 5.x 构建纯 XML POST 请求（推荐方式）
这是最常见也最轻量的做法：把 XML 字符串或字节流作为请求体，用 StringEntity 或 ByteArrayEntity 封装。关键点在于手动设置 Content-Type 头，且编码必须与 XML 声明一致（如 ）。
HttpClient client = HttpClientBuilder.create().build(); String xmlData = ""; HttpEntity entity = new StringEntity(xmlData, ContentType.create("application/xml", Consts.UTF_8)); Alice HttpPost post = new HttpPost("https://www.php.cn/link/1e2d681b253cb12c33f7b4823af01d79"); post.setEntity(entity);
HttpResponse response = client.execute(post);
-
ContentType.create("application/xml", Consts.UTF_8)确保请求头含Content-Type: application/xml; charset=UTF-8 - 如果 XML 字符串本身含 BOM 或编码不一致，服务端可能解析失败；建议统一用 UTF-8 且不带 BOM
- 避免用
TextEntity（已废弃），优先用StringEntity或ByteArrayEntity
需要真正“上传文件”时才用 Multipart（比如接口明确要求 form-data）
某些后端强制要求 multipart/form-data，并把 XML 当作一个命名字段（如 file 或 xml_data）。这时不能用纯 XML 请求体，必须构造 multipart 实体。HttpClient 5.x 需要额外依赖 httpmime 模块。
立即学习“Java免费学习笔记（深入）”；
org.apache.httpcomponents httpmime 4.5.14
代码示例（使用 MultipartEntityBuilder）：
File xmlFile = new File("data.xml");
FileBody fileBody = new FileBody(xmlFile, ContentType.create("application/xml"));
MultipartEntityBuilder builder = MultipartEntityBuilder.create();
builder.addPart("xml_file", fileBody); // 字段名需和服务端约定一致
HttpEntity entity = builder.build();
HttpPost post = new HttpPost("https://www.php.cn/link/f142c6067e6345134c6728f299cf4c1e");
post.setEntity(entity);
HttpResponse response = client.execute(post);
- 字段名
"xml_file"必须和服务端接收参数名完全匹配 - 如果服务端期望的是文本字段而非文件字段（例如接收
... FileBody，会导致多一层 base64 或二进制包装，大概率报错 -
httpmime在 HttpClient 5.x 中支持有限，生产环境若用 5.x，建议降级到 4.5.x 的稳定组合，或改用java.net.http.HttpClient（JDK 11+）+ 手动构造 multipart
容易忽略的坑：字符编码、XML 格式校验和连接配置
看似简单的 XML POST，实际出错常不在逻辑，而在细节。
- XML 字符串里含中文但没声明
encoding="UTF-8"，或声明了却用GBK编码构造实体，服务端收到乱码 - 忘记调用
post.setHeader("Accept", "application/xml")，某些严格接口会拒收非预期 Accept 头的请求 - 未设置超时：
RequestConfig必须显式配置setConnectTimeout和setSocketTimeout，否则默认无限等待 - 服务端返回 400 却不给错误详情？试试用
response.getEntity().getContent()读取响应体，很多 XML 接口在失败时仍返回带错误信息的 XML
最麻烦的情况是服务端文档写得模糊：“支持 XML 提交”，却不说明到底要纯 body 还是 multipart，也不说字段名和 Content-Type 要求。这时候只能抓包对比成功请求，或直接联系对接方确认——别靠猜。
