共计 2648 个字符，预计需要花费 7 分钟才能阅读完成。

异常背景

WindowManager$BadTokenException是 Android 开发中常见的运行时异常，错误信息通常表现为：

android.view.WindowManager$BadTokenException: Unable to add window -- token null is not valid

这个异常的根本原因是系统无法验证窗口的合法性。当我们需要通过 WindowManager 添加悬浮窗、对话框等窗口时，系统会检查传入的 Context 是否包含有效的窗口令牌（Window Token）。

常见触发场景

• 使用已销毁的 Activity 的 Context
• 在非 UI 线程中错误地使用 Context
• 使用 Application Context 代替 Activity Context
• 在 Service 或 BroadcastReceiver 中直接显示对话框

原因分析

Android 的窗口系统依赖于令牌（Token）机制来管理窗口层级和权限。每个 Activity 在创建时都会获得一个唯一的 Window Token，这个 Token 会随着 Activity 的生命周期变化。

当调用 WindowManager.addView() 时，系统会：

1. 检查传入的 Context 是否关联有效的 Window Token
2. 验证调用线程是否为主线程
3. 检查窗口类型是否匹配 Context 的权限

如果其中任何一项验证失败，就会抛出BadTokenException。

解决方案

1. 确保使用有效的 Activity Context

对话框、悬浮窗等需要附加到 Activity 窗口层级中的视图，必须使用 Activity Context：

// 正确方式
AlertDialog.Builder(this@MainActivity) // 使用 Activity 实例
    .setTitle("提示")
    .setMessage("这是一个对话框")
    .show()

2. 检查 Activity 状态

在可能异步显示窗口的场景中，必须先检查 Activity 是否有效：

if (!isFinishing && !isDestroyed) {
    // 安全显示对话框
    dialog.show()}

3. 正确处理 Application Context

Application Context 没有关联的 Window Token，只能用于特定场景：

• 系统级窗口（需要 SYSTEM_ALERT_WINDOW 权限）
• 不附加到 Activity 的独立窗口

// 需要声明权限
if (Settings.canDrawOverlays(context)) {
    val params = WindowManager.LayoutParams(
        WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY,
        ...
    )
    windowManager.addView(myView, params)
}

4. 线程安全处理

所有窗口操作必须在主线程执行：

runOnUiThread {if (!isDestroyed) {dialog.show()
    }
}

5. 使用 View.post 延迟执行

在 Activity 刚创建时，Window Token 可能还未准备好：

view.post {
    // 此时 Window Token 已准备好
    dialog.show()}

完整代码示例

Kotlin 解决方案

// 安全显示对话框的扩展函数
fun Activity.showSafeDialog(dialog: Dialog) {if (!isFinishing && !isDestroyed) {
        runOnUiThread {if (!isFinishing && !isDestroyed) {
                try {dialog.show()
                } catch (e: WindowManager.BadTokenException) {Log.e("DialogError", "Failed to show dialog", e)
                }
            }
        }
    }
}

// 使用示例
class MainActivity : AppCompatActivity() {
    private lateinit var dialog: AlertDialog

    override fun onCreate(savedInstanceState: Bundle?) {super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        dialog = AlertDialog.Builder(this)
            .setTitle("安全对话框")
            .setMessage("这是一个正确处理了 Window Token 的对话框")
            .create()

        // 模拟异步显示
        lifecycleScope.launch {delay(1000)
            showSafeDialog(dialog)
        }
    }
}

最佳实践

1. Context 选择原则：
2. 需要附加到 Activity 的窗口 → 使用 Activity Context
3. 系统级悬浮窗 → 使用 Application Context + 特殊权限

4. 其他情况 → 优先使用 Activity Context

5. 生命周期管理：

6. 在 onPause 中隐藏临时窗口

7. 在 onDestroy 中移除所有窗口引用

8. 异常防御：

9. 所有窗口操作包裹 try-catch
10. 异步操作前检查 Activity 状态

进阶思考

多线程场景

在协程 /RxJava 等异步框架中，必须确保窗口操作最终在主线程执行：

viewModelScope.launch(Dispatchers.IO) {
    // 后台工作
    withContext(Dispatchers.Main) {if (!isDestroyed) showDialog()}
}

跨进程通信

通过 AIDL 跨进程显示窗口时，需要特别注意：

1. 验证客户端 Activity 是否存在
2. 使用 Binder.getCallingUid() 检查调用方权限
3. 考虑使用 PendingIntent 代替直接窗口操作

自查清单

遇到 BadTokenException 时，按此清单检查：

• [] 是否使用了正确的 Context 类型
• [] Activity 是否已销毁
• [] 是否在主线程执行
• [] Window Token 是否已准备好
• [] 是否声明了必要权限

学习资源

1. Android 窗口管理系统官方文档
2. DialogFragment 使用指南
3. WindowManager 源码分析

通过理解 Window Token 的工作原理和掌握这些实践技巧，你可以有效避免BadTokenException，构建更稳定的 Android 应用。在实际开发中，建议将窗口操作封装为可重用的工具类，统一处理各种边界情况。