Android中MultipartUploadRequest在AsyncTask的doInBackground无法工作

你遇到的这个情况——在UI线程里执行MultipartUploadRequest一切正常，但放到AsyncTask的doInBackground方法里就没反应也没报错，核心原因基本可以锁定是这个上传库的内部逻辑依赖UI线程的运行环境。

很多带通知、进度回调的上传库，会用到UI线程的Handler、Looper，或者需要操作通知栏这类UI相关组件，而doInBackground是在后台线程执行的，默认没有绑定Looper，也无法直接操作UI相关的系统服务，这就导致库的初始化或者后续执行逻辑卡住了，又没抛出可见的错误。

最直接的解决方案：把上传操作移到onPostExecute方法里 #

AsyncTask的onPostExecute是在UI线程执行的，和你之前在UI线程里调用上传的环境完全一致，这样就能避开后台线程的限制。修改你的ScanFacesAsyncTask代码如下：

public class ScanFacesAsyncTask extends AsyncTask<Object, Void, Boolean> {
    // 提前保存需要的参数，避免在后台线程直接持有Activity引用导致内存泄漏
    private Context appContext;
    private String uploadID;
    private String serverUrlString;
    private File photo;
    private String key;
    private Object data;
    private UploadNotificationConfig uploadNotificationConfig;

    // 通过构造方法传入所需参数，用ApplicationContext避免内存泄漏
    public ScanFacesAsyncTask(Context context, String uploadID, String serverUrlString, 
                              File photo, String key, Object data, 
                              UploadNotificationConfig uploadNotificationConfig) {
        this.appContext = context.getApplicationContext();
        this.uploadID = uploadID;
        this.serverUrlString = serverUrlString;
        this.photo = photo;
        this.key = key;
        this.data = data;
        this.uploadNotificationConfig = uploadNotificationConfig;
    }

    @Override
    protected Boolean doInBackground(Object... params) {
        // 这里只专注做图片处理的异步逻辑
        return processImage(); // 返回处理结果：true表示处理成功
    }

    @Override
    protected void onPostExecute(Boolean isProcessSuccess) {
        super.onPostExecute(isProcessSuccess);
        // 上传操作移到这里，因为onPostExecute运行在UI线程
        if (isProcessSuccess) {
            new MultipartUploadRequest(appContext, uploadID, serverUrlString)
                    .setAutoDeleteFilesAfterSuccessfulUpload(true)
                    .setMethod("POST")
                    .addHeader("x-amz-acl", "bucket-owner-full-control")
                    .addFileToUpload(photo.getAbsolutePath(), "file")
                    .addParameter("key", key)
                    .addParameter("acl", "bucket-owner-full-control")
                    .addParameter("success_action_status", "201")
                    .addParameter("data", data.toString())
                    .setNotificationConfig(uploadNotificationConfig)
                    .setMaxRetries(2)
                    .startUpload();
        }
    }
}

额外的排查与优化建议 #

• 添加日志与回调监听：如果之后还是有问题，给上传请求添加错误回调（如果库支持的话），比如setErrorListener或者setDelegate，同时在processImage()里添加日志，确认图片处理是否真的完成了，这样能快速定位问题点。
• 避免内存泄漏：永远不要在AsyncTask里直接持有Activity的强引用，用getApplicationContext()或者弱引用，防止Activity销毁后任务还在运行导致内存泄漏。
• 权限确认：虽然UI线程能正常上传，但还是可以确认一下后台线程执行时，网络权限、文件读取权限是否正常（比如Android 10+的文件访问权限）。

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