OkHttp 上传 XML 文件的核心是正确构建 RequestBody:若用 MultipartBody 则按文件处理,若直接 POST 则用 RequestBody.create() 并设 Content-Type 为 application/xml;禁用 FormBody 以免 URL 编码破坏格式。

OkHttp 上传 XML 文件的核心是 RequestBody 构建
OkHttp 本身不区分“XML 文件”或“其他文件”,它只关心你传入的 RequestBody 是否正确封装了二进制数据和 MIME 类型。关键不是“XML”,而是“文件内容 + 正确的 Content-Type”。如果你用 MultipartBody,就按普通文件上传处理;如果直接 POST 原始 XML 字符串,就用 RequestBody.create()。
- XML 文件本质是文本,但上传时建议统一用
application/xml或text/xml,服务端通常更认前者 - 不要试图用
FormBody上传整个 XML 字符串——它会 URL 编码,破坏格式且服务端无法解析 - 若 XML 内容不大(String 后创建
RequestBody;否则务必用File+RequestBody.create()避免 OOM
使用 MultipartBody 上传 XML 文件(推荐)
这是最通用、兼容性最强的方式,尤其适合带其他字段(如 token、id)一起上传的场景。服务端一般通过 multipart/form-data 解析,对文件名、类型都支持明确声明。
File xmlFile = new File("/sdcard/test.xml");
RequestBody fileBody = RequestBody.create(xmlFile, MediaType.get("application/xml"));
MultipartBody.Builder builder = new MultipartBody.Builder()
.setType(MultipartBody.FORM)
.addFormDataPart("file", "test.xml", fileBody) // 第二个参数是服务端接收的文件名
.addFormDataPart("userId", "12345")
.addFormDataPart("token", "abcde123");
Request request = new Request.Builder()
.url("https://api.example.com/upload")
.post(builder.build())
.build();
// 执行请求(需在子线程)
okHttpClient.newCall(request).enqueue(...);
-
RequestBody.create(File, MediaType)是 OkHttp 4.9+ 的写法;旧版本用RequestBody.create(MediaType, File) - 注意
addFormDataPart("file", ...)中第一个"file"是服务端 expect 的表单字段名,必须和服务端约定一致 - Android 10+ 访问外部存储需适配 Scoped Storage,
xmlFile路径不能硬写/sdcard/,应通过getExternalFilesDir()或ContentResolver获取
直接 POST 原始 XML 字符串(轻量场景)
当服务端接受纯 XML body(即不走 form-data,而是直接读取 request body),就跳过 MultipartBody,用 RequestBody.create() 直接构造。
支付宝账户登录ecshop插件简介: 先向支付宝申请支付接口,拿到合作身份者ID和安全检验码这两个东西。 把login整个文件夹传到服务器上ecshop安装所在的目录,如果路径不对可以会导致使用失败。 需要修改的文件:alipay_config.php return_url.php可以修改第30行的邮箱域名为你的网站域名。 别的不用改,否则会导致无法使用。
String xmlContent = ""; RequestBody body = RequestBody.create( xmlContent.getBytes(StandardCharsets.UTF_8), MediaType.get("application/xml; charset=utf-8") ); Request request = new Request.Builder() .url("https://api.example.com/submit") .post(body) .header("Content-Type", "application/xml; charset=utf-8") // 显式设 header 更稳妥 .build(); Alice
- 务必显式指定
charset=utf-8,否则某些服务端(如 Spring Boot 默认配置)可能按 ISO-8859-1 解析,导致中文乱码 - 不要用
xmlContent.getBytes()无参重载——它依赖系统默认编码,在 Android 上可能是 UTF-8,但不可靠 - 这种模式下没有“文件名”概念,服务端只能解析 body,不能获取原始文件名
常见错误:400 / 415 错误与 Content-Type 不匹配
上传失败返回 400 Bad Request 或 415 Unsupported Media Type 时,90% 是因为服务端收到的 Content-Type 和它期望的不一致。
- 检查 OkHttp 日志(开启
HttpLoggingInterceptor)确认实际发出的Content-Type头是否为application/xml或multipart/form-data; boundary=... - Spring Boot 后端若用
@RequestBody String xml,必须匹配application/xml;若用@RequestParam MultipartFile file,则必须走MultipartBody - Android 端不要手动拼接
boundary——MultipartBody.Builder会自动生成并设置,手写极易出错
"file" ≠ "File")、以及 UTF-8 字节序列和 charset 声明的严格对应。这三个点卡住,其他都白搭。









