Android Retrofit：如何在非主线程中准备大型JSON请求体

核心思路是把大型JSON对象的组装、序列化工作完全放到后台线程，完成后再发起Retrofit请求，避免占用主线程资源导致UI卡顿。以下是几种主流实现方案：

方案1：Kotlin 协程（Android现代开发首选） #

协程天然支持线程切换，借助Dispatchers.IO在后台处理耗时的JSON准备工作，再通过viewModelScope或lifecycleScope自动管理生命周期，避免内存泄漏。

// 在ViewModel或Activity/Fragment中调用
viewModelScope.launch(Dispatchers.IO) {
    // 后台线程完成大型数据模型的组装
    val largeDataModel = buildLargeDataModel()
    // 若需手动序列化（如自定义JSON格式），也放在这里执行
    val jsonString = Gson().toJson(largeDataModel)
    
    // 发起Retrofit请求（suspend函数会自动在IO线程执行网络操作）
    runCatching {
        apiService.postLargeData(largeDataModel)
    }.onSuccess { response ->
        withContext(Dispatchers.Main) {
            // 主线程处理成功结果
            updateUI(response)
        }
    }.onFailure { error ->
        withContext(Dispatchers.Main) {
            // 主线程处理错误
            showError(error)
        }
    }
}

// 耗时的数据组装逻辑
private fun buildLargeDataModel(): LargeDataModel {
    // 这里做大量数据拼接、列表填充等操作
    return LargeDataModel(
        // 填充字段、嵌套对象、集合等内容
    )
}

方案2：Java 线程池（兼容Java项目） #

用自定义线程池处理后台任务，Retrofit请求的回调可通过指定CallbackExecutor直接回到主线程，无需手动切换。

// 全局单例线程池（避免重复创建线程）
private static final ExecutorService IO_EXECUTOR = Executors.newSingleThreadExecutor();

// 在主线程触发任务
IO_EXECUTOR.execute(() -> {
    // 后台线程组装大型数据模型
    LargeDataModel largeDataModel = buildLargeDataModel();
    String jsonString = new Gson().toJson(largeDataModel);
    
    // 发起Retrofit请求，通过CallbackExecutor指定主线程回调
    apiService.postLargeData(largeDataModel).enqueue(new Callback<Response>() {
        @Override
        public void onResponse(Call<Response> call, retrofit2.Response<Response> response) {
            // 已在主线程，直接更新UI
            updateUI(response);
        }

        @Override
        public void onFailure(Call<Response> call, Throwable t) {
            // 主线程处理错误
            showError(t);
        }
    });
});

private LargeDataModel buildLargeDataModel() {
    // 耗时的数据组装逻辑
    return new LargeDataModel();
}

方案3：RxJava（适配已有RxJava的项目） #

利用RxJava的线程调度器，将数据准备工作放到io()线程，请求结果切回main()线程处理。

Observable.fromCallable(() -> {
    // 后台线程完成数据组装
    return buildLargeDataModel();
})
.subscribeOn(Schedulers.io())
.flatMap(largeDataModel -> apiService.postLargeDataRx(largeDataModel))
.observeOn(AndroidSchedulers.mainThread())
.subscribe(
    response -> updateUI(response),
    error -> showError(error)
);

关键优化细节 #

• 序列化工具复用：提前创建Gson/Moshi单例，避免每次初始化带来的开销；Moshi可使用预编译适配器进一步提升序列化速度。
• 数据缓存：如果大型JSON的部分内容固定，可提前缓存这些片段，避免重复构建。
• 内存管控：大型对象可能占用较多内存，注意在生命周期结束时取消后台任务（如协程的viewModelScope自动取消），避免内存泄漏。

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