Android创建AlertDialog触发ViewRootCalledFromWrongThreadException问题解决

错误原因 #

Android系统强制要求：所有UI组件的修改操作必须在主线程（UI线程）中执行。你在处理网络请求时，大概率是在子线程中执行请求逻辑（比如用Thread、OkHttp异步回调、RxJava非主线程调度等），而txt.append(".")是直接在子线程中操作TextView这个UI组件，违反了Android的线程安全规则，因此触发ViewRootImpl$CalledFromWrongThreadException异常。

额外注意：AlertDialog的显示（show()）和取消（dismiss()）也属于UI操作，若在子线程中执行这两个方法，同样会引发同类异常。

修复方法 #

以下是几种常用的将UI操作切换到主线程的实现方式：

1. 使用Activity的runOnUiThread()方法 #

如果代码在Activity类中，可直接用runOnUiThread()包裹UI操作：

// 在子线程的网络请求逻辑中
runOnUiThread(new Runnable() {
    @Override
    public void run() {
        txt.append(".");
        // 取消AlertDialog也需放在这里执行
        // alertDialog.dismiss();
    }
});

2. 使用主线程Handler #

创建绑定主线程Looper的Handler，通过发送消息触发主线程的UI操作：

// 在Activity主线程初始化（比如onCreate方法内）
private Handler mainHandler = new Handler(Looper.getMainLooper()) {
    @Override
    public void handleMessage(Message msg) {
        super.handleMessage(msg);
        if (msg.what == 1) {
            txt.append(".");
        } else if (msg.what == 2) {
            alertDialog.dismiss();
        }
    }
};

// 在子线程中发送消息
mainHandler.sendEmptyMessage(1); // 更新TextView
// mainHandler.sendEmptyMessage(2); // 取消AlertDialog

3. 使用AsyncTask（适用于简单网络请求场景） #

AsyncTask封装了线程切换逻辑，onPreExecute()、onProgressUpdate()、onPostExecute()均运行在主线程：

private class NetworkRequestTask extends AsyncTask<Void, String, Boolean> {
    private AlertDialog loadingDialog;

    @Override
    protected void onPreExecute() {
        super.onPreExecute();
        // 主线程中显示加载对话框
        loadingDialog = new AlertDialog.Builder(MainActivity.this)
                .setMessage("加载中...")
                .create();
        loadingDialog.show();
    }

    @Override
    protected Boolean doInBackground(Void... voids) {
        // 子线程执行网络请求
        // 模拟请求过程，定期更新进度
        for (int i = 0; i < 5; i++) {
            try {
                Thread.sleep(500);
                publishProgress("."); // 发送进度到主线程
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
        }
        return true; // 模拟请求成功
    }

    @Override
    protected void onProgressUpdate(String... values) {
        super.onProgressUpdate(values);
        // 主线程更新TextView
        txt.append(values[0]);
    }

    @Override
    protected void onPostExecute(Boolean result) {
        super.onPostExecute(result);
        // 主线程取消对话框
        if (loadingDialog != null && loadingDialog.isShowing()) {
            loadingDialog.dismiss();
        }
    }
}

// 启动任务
new NetworkRequestTask().execute();

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