安卓Activity销毁时Dialog显示问题解决方案

1. 安卓Activity销毁时显示Dialog的经典问题

在安卓开发中，Activity生命周期管理是个永恒的话题。我见过太多开发者踩过这样的坑：当Activity正在销毁时尝试显示Dialog，结果直接引发WindowManager$BadTokenException崩溃。这种场景在异步任务回调时尤其常见——比如网络请求返回时Activity已经不在前台了。

问题的本质在于：Dialog的显示必须依附于一个有效的Window token。当Activity进入销毁流程时，它的Window token会被回收，此时任何试图创建或显示Dialog的操作都会失败。日志通常会显示类似这样的错误：

code复制android.view.WindowManager$BadTokenException: 
Unable to add window -- token android.os.BinderProxy@XXX is not valid

2. 生命周期与Window token机制解析

2.1 Activity销毁流程的关键节点

理解这个问题的核心在于掌握Activity销毁时各回调的执行顺序：

1. onPause()：Activity失去焦点时立即触发
2. onStop()：Activity完全不可见时触发
3. onDestroy()：最终销毁前的回调

关键点：在onStop()之后，Activity的Window token就已经失效了。但很多开发者误以为只要不执行onDestroy()就安全，这是典型的认知误区。

2.2 Window token的工作原理

Window token是系统用来验证窗口合法性的机制。每个Activity在创建时会被分配唯一的token，这个token会在以下情况被回收：

• 用户按下返回键退出Activity
• 调用finish()主动销毁
• 系统因内存不足回收Activity
• 屏幕旋转等配置变化导致Activity重建

重要提示：即使Activity对象还在内存中，只要它的Window token被回收，任何与该Activity关联的UI操作都会失败。

3. 五种实战解决方案对比

3.1 方案一：isFinishing()基础检查

最简单的防御性编程是在显示Dialog前检查Activity状态：

java复制if (!isFinishing() && !isDestroyed()) {
    new AlertDialog.Builder(this)
        .setTitle("提示")
        .setMessage("操作成功")
        .show();
}

优缺点：

• 优点：实现简单，能拦截大部分异常场景
• 缺点：无法处理异步回调时可能出现的竞态条件

3.2 方案二：使用DialogFragment

Google官方推荐使用DialogFragment替代直接创建Dialog：

java复制public class MyDialogFragment extends DialogFragment {
    @Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        return new AlertDialog.Builder(getActivity())
            .setTitle("提示")
            .setMessage("使用Fragment管理的对话框")
            .create();
    }
}

// 显示方式
new MyDialogFragment().show(getSupportFragmentManager(), "dialog_tag");

优势分析：

1. 自动处理生命周期
2. 屏幕旋转时自动重建
3. 通过FragmentManager管理显示状态
4. 可以复用对话框逻辑

3.3 方案三：弱引用+生命周期监听

结合弱引用和LifecycleObserver实现安全回调：

java复制public class SafeDialogHelper implements LifecycleObserver {
    private final WeakReference<Activity> activityRef;
    
    public SafeDialogHelper(Activity activity) {
        this.activityRef = new WeakReference<>(activity);
        activity.getLifecycle().addObserver(this);
    }
    
    @OnLifecycleEvent(Lifecycle.Event.ON_DESTROY)
    public void onDestroy() {
        Activity activity = activityRef.get();
        if (activity != null) {
            activity.getLifecycle().removeObserver(this);
        }
    }
    
    public void showDialog(String message) {
        Activity activity = activityRef.get();
        if (activity != null && !activity.isFinishing()) {
            new AlertDialog.Builder(activity)
                .setMessage(message)
                .show();
        }
    }
}

3.4 方案四：全局Dialog管理

对于需要全局显示Dialog的场景（如网络错误提示），可以设计一个集中式管理类：

java复制public class DialogManager {
    private static Dialog currentDialog;
    
    public static void showGlobalDialog(Context context, String msg) {
        dismissCurrent();
        
        if (context instanceof Activity) {
            Activity activity = (Activity) context;
            if (!activity.isFinishing()) {
                currentDialog = new AlertDialog.Builder(context)
                    .setMessage(msg)
                    .setPositiveButton("确定", null)
                    .show();
            }
        } else {
            // 处理非Activity Context的情况
            currentDialog = new AlertDialog.Builder(context)
                .setMessage(msg)
                .setPositiveButton("确定", null)
                .create();
            currentDialog.getWindow().setType(WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY);
            currentDialog.show();
        }
    }
    
    public static void dismissCurrent() {
        if (currentDialog != null && currentDialog.isShowing()) {
            currentDialog.dismiss();
        }
    }
}

3.5 方案五：View.postDelayed安全检测

对于需要延迟显示Dialog的场景，可以使用View的post机制：

java复制view.postDelayed(() -> {
    if (!isFinishing() && getWindow() != null 
        && getWindow().getDecorView().getWindowToken() != null) {
        showDialog();
    }
}, 1000);

4. 特殊场景下的处理技巧

4.1 异步任务中的Dialog处理

处理网络请求等异步操作时，推荐使用RxJava或Kotlin协程的生命周期感知：

kotlin复制// 使用RxJava自动订阅管理
disposable = apiService.fetchData()
    .subscribeOn(Schedulers.io())
    .observeOn(AndroidSchedulers.mainThread())
    .autoDispose(this) // 使用RxLifecycle等库
    .subscribe({ result ->
        if (!isDestroyed) {
            showResultDialog(result)
        }
    }, { error ->
        if (!isDestroyed) {
            showErrorDialog(error)
        }
    })

4.2 多Fragment环境下的Dialog协调

当Activity包含多个Fragment时，建议采用事件总线机制：

1. 定义Dialog显示事件：

java复制public class ShowDialogEvent {
    public final String message;
    public ShowDialogEvent(String message) {
        this.message = message;
    }
}

2. 在BaseActivity中处理：

java复制@Subscribe(threadMode = ThreadMode.MAIN)
public void onShowDialogEvent(ShowDialogEvent event) {
    if (!isFinishing()) {
        new AlertDialog.Builder(this)
            .setMessage(event.message)
            .show();
    }
}

4.3 后台服务中显示Dialog

从Service等非UI组件显示Dialog需要特殊处理：

java复制// 在AndroidManifest.xml中声明权限
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>

// 代码实现
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    dialog.getWindow().setType(WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY);
} else {
    dialog.getWindow().setType(WindowManager.LayoutParams.TYPE_SYSTEM_ALERT);
}

5. 性能优化与内存管理

5.1 Dialog泄漏检测

使用LeakCanary等工具检测Dialog内存泄漏：

gradle复制debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.9.1'

常见泄漏场景：

• 持有Activity引用的匿名DialogInterface.OnClickListener
• 静态变量持有Dialog引用
• 未及时取消的Dialog显示定时任务

5.2 复用Dialog实例

对于频繁显示的Dialog（如加载框），建议复用实例：

java复制public class LoadingDialog {
    private static Dialog loadingDialog;
    
    public static void show(Context context) {
        dismiss();
        
        if (context instanceof Activity && !((Activity) context).isFinishing()) {
            loadingDialog = new Dialog(context);
            loadingDialog.setContentView(R.layout.dialog_loading);
            loadingDialog.setCancelable(false);
            loadingDialog.show();
        }
    }
    
    public static void dismiss() {
        if (loadingDialog != null && loadingDialog.isShowing()) {
            loadingDialog.dismiss();
        }
    }
}

6. 兼容性处理与测试要点

6.1 不同安卓版本的差异

• Android 7.0及以上：必须处理配置变化导致的Window token失效
• Android 8.0：后台服务弹窗需要特殊权限
• Android 10：深色主题适配问题
• Android 11：悬浮窗权限变更

6.2 自动化测试方案

使用Espresso进行Dialog测试时注意：

java复制@Test
public void testDialogShow() {
    onView(withId(R.id.btn_show_dialog)).perform(click());
    
    // 检查Dialog标题
    onView(withText("提示")).inRoot(isDialog())
        .check(matches(isDisplayed()));
        
    // 模拟Activity销毁
    getActivity().finish();
    
    // 验证不会因Activity销毁导致崩溃
    try {
        onView(withText("确定")).inRoot(isDialog()).perform(click());
    } catch (NoMatchingRootException e) {
        // 预期中的异常
    }
}

7. 最佳实践总结

经过多年踩坑经验，我总结出以下黄金准则：

1. 优先使用DialogFragment：这是Google官方推荐方案，能自动处理大部分生命周期问题
2. 双重状态检查：同时检查isFinishing()和isDestroyed()
3. 异步操作加锁：使用AtomicBoolean等机制防止重复显示
4. 统一错误处理：所有Dialog显示操作都要包裹try-catch
5. 监控Window token：通过getWindow().getDecorView().getWindowToken()实时验证

最后分享一个我常用的工具类：

java复制public class DialogUtils {
    public static boolean safeShowDialog(Activity activity, Dialog dialog) {
        try {
            if (activity != null && !activity.isFinishing() && !activity.isDestroyed()
                && dialog != null && !dialog.isShowing()) {
                dialog.show();
                return true;
            }
        } catch (Exception e) {
            Log.e("DialogUtils", "show dialog error", e);
        }
        return false;
    }
}

这个方案在我参与的多个大型项目中验证过稳定性，希望能帮助开发者们彻底告别BadTokenException的困扰。