使用Retrofit2下载大文件时进程静默终止问题求助

这种大文件下载中途悄无声息挂掉的情况我之前也碰到过，大概率是几个常见的坑在搞鬼，咱们一步步排查解决：

1. 确保Retrofit用流式下载，避免内存溢出 #

首先，Retrofit默认会把ResponseBody全部加载到内存里，这对大文件来说绝对是灾难。必须加上@Streaming注解，直接操作流写入磁盘，而不是先读进内存：

@Streaming
@GET
Call<ResponseBody> downloadLargeFile(@Url String fileUrl);

在处理响应的时候，一定要直接获取输入流，绝对不要调用responseBody.string()或者responseBody.bytes()——这两个方法会把整个文件读进内存，直接触发OOM导致进程崩溃：

call.enqueue(new Callback<ResponseBody>() {
    @Override
    public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
        if (response.isSuccessful()) {
            // 用try-with-resources自动关闭流，避免资源泄漏
            try (InputStream inputStream = response.body().byteStream();
                 FileOutputStream outputStream = new FileOutputStream(targetFile)) {
                byte[] buffer = new byte[8192]; // 8KB缓冲区，不要设太大
                int bytesRead;
                long totalBytesRead = 0;
                long fileSize = response.body().contentLength();
                while ((bytesRead = inputStream.read(buffer)) != -1) {
                    outputStream.write(buffer, 0, bytesRead);
                    totalBytesRead += bytesRead;
                    // 不要每读一次就发进度，建议每累计1MB或者几秒更新一次
                    if (totalBytesRead % 1024 * 1024 == 0) {
                        publishProgress(totalBytesRead, fileSize);
                    }
                }
                outputStream.flush();
            } catch (IOException e) {
                e.printStackTrace();
                // 这里一定要捕获异常，别让它悄悄导致进程崩溃
            }
        }
    }

    @Override
    public void onFailure(Call<ResponseBody> call, Throwable t) {
        t.printStackTrace();
    }
});

2. 替换AsyncTask/IntentService，用更可靠的后台任务方案 #

AsyncTask本身就不适合长时间运行的任务，而且在Android 11+的后台限制下很容易被系统干掉；IntentService在API 30已经被弃用了，它的工作线程在任务完成后会自动销毁，也不适合大文件下载这种长耗时操作。

推荐用Foreground Service + WorkManager组合：

• Foreground Service：显示一个下载通知，让系统知道这是用户主动发起的任务，不会轻易杀死进程。
• WorkManager：保证任务在设备重启、系统资源紧张时也能继续执行，适合这种需要可靠完成的长任务。

3. 调整OkHttpClient的超时设置 #

默认的OkHttp超时时间（比如读取超时10秒）对于大文件下载来说太短了，网络波动或者服务器响应慢都会导致连接被断开，而且可能没有明显的日志。你需要把超时时间调长：

OkHttpClient client = new OkHttpClient.Builder()
        .connectTimeout(30, TimeUnit.SECONDS)
        .readTimeout(30, TimeUnit.MINUTES) // 读取超时设为30分钟，根据实际情况调整
        .writeTimeout(30, TimeUnit.MINUTES)
        .cache(null) // 禁用OkHttp缓存，大文件缓存会占用大量存储/内存
        .build();

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl(BASE_URL)
        .client(client)
        .build();

4. 排查存储与流处理细节 #

• 检查存储空间：5GB的文件需要足够的内部存储，下载前先判断剩余空间是否大于文件大小，避免因为空间不足导致写入失败。
• 避免频繁UI更新：如果每次写入缓冲区都发布进度，可能会导致UI线程频繁更新，甚至引发ANR，间接让系统杀死进程。建议累计一定字节数（比如1MB）再更新一次进度。
• 确认流的正确关闭：一定要用try-with-resources语法（Java 7+支持）自动关闭流，或者在finally块里手动关闭，防止资源泄漏积累导致进程崩溃。

5. 捕获全局异常，排查静默崩溃 #

进程静默终止很可能是因为未捕获的异常，你可以设置全局异常处理器来捕获这些异常，并写入本地文件方便排查：

Thread.setDefaultUncaughtExceptionHandler((thread, throwable) -> {
    // 把异常信息写入本地文件
    try (FileWriter writer = new FileWriter(new File(getFilesDir(), "download_crash.log"), true)) {
        writer.write(new Date().toString() + "\n");
        throwable.printStackTrace(new PrintWriter(writer));
        writer.write("\n-------------------------\n");
    } catch (IOException e) {
        e.printStackTrace();
    }
});

另外，在Android Studio的Run面板里切换到Terminated标签，查看进程被杀死的原因——有时候系统会在这里输出OOM或者后台限制的日志。

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