Android中调用Utility.kt弹窗函数报token null无效错误原因排查

嘿，我来帮你分析下这个问题！你遇到的WindowManager$BadTokenException本质上是Dialog找不到有效的窗口依附对象导致的，咱们一步步拆解：

问题还原 #

你之前在Activity里直接写的Code A能正常弹出对话框，为了复用代码把promptBuyWhenExpired抽离到Utility.kt工具类后，在onCreate()里调用就抛出了这个错误：

java.lang.RuntimeException: Unable to start activity ComponentInfo{info.dodata.mirror/ui.UIMain}: android.view.WindowManager$BadTokenException: Unable to add window -- token null is not valid; is your activity running?

根本原因 #

Dialog的显示依赖于活跃的Activity窗口的token，这个token是Activity窗口的唯一标识。如果你的工具类函数里用了ApplicationContext（比如全局上下文、或者调用时传错了Context类型），就会因为ApplicationContext没有绑定到具体的Activity窗口，导致Dialog获取不到有效的token，进而抛出这个错误。

解决方案 #

这里给你几个靠谱的解决办法，按需选择：

1. 让工具类函数接收Activity类型的Context

这是最直接的方案，确保Dialog绑定到当前活跃的Activity：

// Utility.kt 里修改函数
fun promptBuyWhenExpired(activity: Activity) {
    val dialog = AlertDialog.Builder(activity)
        .setTitle("会员过期提示")
        .setMessage("您的会员已过期，请及时续费以继续使用全部功能")
        .setPositiveButton("立即续费") { _, _ ->
            // 在这里处理跳转续费页面的逻辑
        }
        .setNegativeButton("稍后再说", null)
        .create()
    dialog.show()
}

然后在Activity的onCreate()里调用时，直接传入当前Activity实例：

// UIMain.kt 的 onCreate() 方法
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    // 关键：传this（当前Activity）而不是applicationContext
    promptBuyWhenExpired(this)
}

2. 改用DialogFragment替代普通Dialog

如果你的场景需要更灵活的弹窗（比如屏幕旋转时自动恢复、适配不同生命周期），用DialogFragment是更好的选择——它依附于Activity的FragmentManager，不需要纠结Context的问题：

// 创建一个DialogFragment子类
class BuyExpiredDialogFragment : DialogFragment() {
    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
        return AlertDialog.Builder(requireActivity())
            .setTitle("会员过期提示")
            .setMessage("您的会员已过期，请及时续费以继续使用全部功能")
            .setPositiveButton("立即续费") { _, _ ->
                // 处理续费逻辑
            }
            .setNegativeButton("稍后再说", null)
            .create()
    }

    companion object {
        // 提供静态方法方便调用
        fun show(manager: FragmentManager) {
            BuyExpiredDialogFragment().show(manager, "BuyExpiredDialog")
        }
    }
}

然后在Activity里调用：

// UIMain.kt 的 onCreate() 方法
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    BuyExpiredDialogFragment.show(supportFragmentManager)
}

3. 检查调用时机是否过早

如果上面两种方法都试过还是有问题，可能是你在Activity还没完全初始化好的时候就调用了弹窗——比如onCreate()里太早执行。这种情况下，可以把弹窗调用延迟到onStart()或者onResume()方法里，确保Activity窗口已经完全激活：

override fun onResume() {
    super.onResume()
    // 在这里调用弹窗函数
    promptBuyWhenExpired(this)
}

总结 #

核心就是：普通Dialog必须绑定到活跃的Activity实例，不能用ApplicationContext；如果想更优雅地处理弹窗生命周期，DialogFragment是更推荐的方案。

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