旧机型运行时出现java.lang.NoClassDefFoundError: org.apache.http.entity.mime.content.FileBody错误

嘿，我之前也踩过类似的旧Android机型Multipart上传的坑，结合你说的“普通请求正常、依赖全加了、试过旧版mimetypes没用”这些信息，问题大概率出在Multipart请求的兼容性细节上，下面给你几个针对性的解决思路：

1. 换掉复杂的Multipart边界字符串 #

旧Android系统（尤其是7.0以下）对Multipart边界里的特殊字符支持很差，比如你要是用了!@#$这类符号当边界，很容易导致服务器解析失败。建议换成纯字母数字加短横线的简单格式，比如：

String boundary = "----UploadBoundary" + System.currentTimeMillis();

同时一定要确保请求头里的Content-Type和边界完全对应：

connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);

2. 别用原生HttpURLConnection构造Multipart，换OkHttp试试 #

原生的HttpURLConnection在旧系统里的Multipart实现有不少bug，直接用成熟的网络库能省很多事。比如OkHttp对旧机型兼容性做了超多优化，如果你还没用到，试试这个上传示例：

OkHttpClient client = new OkHttpClient();
RequestBody requestBody = new MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("image", "my-photo.jpg",
                RequestBody.create(MediaType.parse("image/jpeg"), new File(yourImagePath)))
        .build();

Request request = new Request.Builder()
        .url(yourUploadServerUrl)
        .post(requestBody)
        .build();

Response response = client.newCall(request).execute();

要是已经在用OkHttp，试试降级到3.12.x版本——这个版本支持到Android 2.3+，最新的OkHttp版本已经放弃旧系统了。

3. 别依赖系统自动获取MIME类型，手动指定 #

你说试过旧版本的mimetypes，但可能问题出在获取方式上。旧机型的MimeTypeMap或者ContentResolver.getType()经常返回错误的MIME类型，导致服务器不认文件。干脆直接手动指定：

// 上传JPG就写image/jpeg，PNG写image/png，不用猜
RequestBody imageBody = RequestBody.create(MediaType.parse("image/jpeg"), yourImageFile);

4. 检查TLS版本兼容性 #

如果你的服务器只支持TLS 1.2+，那Android 4.4及以下的机型默认是不启用TLS 1.2的，这时候请求会直接失败（看起来像是上传错误，实际是连不上服务器）。可以在OkHttp里配置启用兼容的TLS版本：

ConnectionSpec spec = new ConnectionSpec.Builder(ConnectionSpec.MODERN_TLS)
        .tlsVersions(TlsVersion.TLS_1_2, TlsVersion.TLS_1_1, TlsVersion.TLS_1_0)
        .build();

OkHttpClient client = new OkHttpClient.Builder()
        .connectionSpecs(Arrays.asList(spec, ConnectionSpec.COMPATIBLE_TLS))
        .build();

5. 抓包对比新老机型的请求差异 #

最后一招，用Charles或者Wireshark抓一下新机型和旧机型的请求包，对比两者的Multipart结构：

• 请求头的Content-Type是不是完全一致
• 请求体里的边界字符串和头里的对不对得上
• 文件内容的编码有没有差异
• 换行符是用了\r\n还是\n（旧系统可能会乱换）
  旧机型经常在这些细节上出问题，抓包对比能快速定位哪里不一样。

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