Retrofit2：含长Base64字符串请求的百分比进度条及方案选型

嘿，我来帮你梳理下这两个问题哈！

一、能不能在进度条中显示Base64图片的上传进度？ #

答案是可以实现，但需要额外做些处理。默认情况下，把Base64字符串直接塞进请求体的话，整个请求体是一次性生成的，Retrofit没法追踪实时发送进度——毕竟整个字符串已经存在内存里，发送时是一次性推给服务器的。

不过我们可以通过自定义RequestBody绕开这个限制：把Base64字符串转换成字节流，在流的读取过程中监听进度，再把进度回调给RxJava的观察者来更新UI。给你个具体的实现示例：

首先定义带进度回调的RequestBody：

public class ProgressRequestBody extends RequestBody {
    private final String base64Content;
    private final ProgressListener listener;

    public ProgressRequestBody(String base64Content, ProgressListener listener) {
        this.base64Content = base64Content;
        this.listener = listener;
    }

    @Override
    public MediaType contentType() {
        return MediaType.parse("application/json"); // 根据你的API要求调整媒体类型
    }

    @Override
    public void writeTo(BufferedSink sink) throws IOException {
        byte[] bytes = base64Content.getBytes(StandardCharsets.UTF_8);
        long totalBytes = bytes.length;
        long writtenBytes = 0;

        listener.onProgress(0);
        // 分块写入流，同时更新进度
        while (writtenBytes < totalBytes) {
            int chunkSize = (int) Math.min(4096, totalBytes - writtenBytes);
            sink.write(bytes, (int) writtenBytes, chunkSize);
            writtenBytes += chunkSize;
            listener.onProgress((int) (100 * writtenBytes / totalBytes));
        }
        sink.flush();
    }

    public interface ProgressListener {
        void onProgress(int progress);
    }
}

然后在Retrofit接口中定义请求：

interface ApiService {
    @POST("your-api-endpoint")
    Single<ResponseBody> uploadBase64Image(@Body RequestBody requestBody);
}

最后结合RxJava使用，更新进度条：

// 假设你已经得到了图片的Base64字符串
String base64Image = "转换后的Base64内容";

ProgressRequestBody requestBody = new ProgressRequestBody(base64Image, progress -> {
    // 在主线程更新进度条
    Observable.just(progress)
            .observeOn(AndroidSchedulers.mainThread())
            .subscribe(percent -> yourProgressBar.setProgress(percent));
});

apiService.uploadBase64Image(requestBody)
        .subscribeOn(Schedulers.io())
        .observeOn(AndroidSchedulers.mainThread())
        .subscribe(response -> {
            // 上传成功后的逻辑
        }, throwable -> {
            // 错误处理逻辑
        });

不过要注意：这种方式本质是模拟流式发送，内存占用还是比直接传文件高——毕竟Base64字符串本身就比原图片大33%，且整个字符串都要存在内存里。

二、Base64嵌入请求体vs直接上传文件，哪个方案更优？ #

优先推荐直接上传文件，原因如下：

• 传输效率更高：Base64编码会让文件体积增大约33%，不仅增加带宽消耗，服务器还要额外做解码操作，性能损耗更大；直接用MultipartBody传二进制文件，体积小，传输和解析都更高效。
• 内存更友好：大图片转成Base64字符串会占用大量内存（比如10MB图片转成Base64后约13MB），容易引发OOM；直接传文件支持流式上传，不用把整个文件加载到内存，对设备内存压力更小。
• 进度监听更简单：Retrofit对Multipart文件上传的进度监听支持更成熟，有很多现成的封装方案，实现起来比Base64的方式更直观。
• 服务器兼容性更好：大部分后端框架对文件上传的支持都很完善，处理Multipart请求比处理大体积Base64字符串更稳定，也不容易出现请求体过大被拦截的问题。

当然，如果你的API硬性要求把图片放在请求体的JSON结构里（比如某些老旧接口），那Base64是没办法的选择，但只要有得选，直接传文件绝对是更优的方案。

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