深入解析Android Activity中的Token机制：原理与避坑指南

1次阅读

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

Activity Token 是 Android 系统为每个 Activity 实例分配的唯一标识符，本质上是一个 Binder 对象的引用。它在窗口管理系统中扮演着以下关键角色：

身份凭证 ：向 WindowManagerService(WMS) 证明 Activity 的合法性，类似 ” 窗口身份证 ”
通信桥梁：作为 Activity 与 WMS 跨进程通信的媒介
生命周期纽带：关联 Activity 与对应的窗口 Surface

官方文档中将其描述为 IBinder 类型，通过 Activity.getActivityToken() 可获取（API 24+）。注意：Application Context 没有 Token，这是引发许多问题的根源。

// 错误示例：在非 Activity Context 中使用窗口相关操作
new AlertDialog.Builder(getApplicationContext()).show(); 
// 抛出：BadTokenException: Unable to add window -- token null is not valid

根本原因：
– Application Context 没有关联的 Window Token
– 对话框 /Toast 等 UI 组件必须依附 Activity 的窗口层级

持有 Activity 的 Token 引用会阻止 GC 回收（如静态存储 Dialog 实例）
表现为内存泄漏后再次使用失效 Token

// 在协程中延迟显示 Toast
lifecycleScope.launch {delay(5000)
    Toast.makeText(this@Activity, "Hi", Toast.LENGTH_SHORT).show()
    // 可能崩溃：Activity 已销毁但 Token 仍被使用
}

必须使用 Activity Context 的场景：
创建对话框（AlertDialog/ProgressDialog）
显示 Toast（除非自定义视图）
PopupWindow 显示
可使用 Application Context 的场景：
启动 Service
获取系统服务
不涉及窗口的操作

// 安全显示 Dialog 方案
fun showDialogSafely(activity: Activity) {if (activity.isFinishing || activity.isDestroyed) return
    AlertDialog.Builder(activity)
        .setTitle("Tips")
        .setPositiveButton("OK") {_, _ ->}
        .show()}

// 协程环境安全示例
lifecycleScope.launchWhenResumed {if (!isActive) return@launchWhenResumed
    Toast.makeText(this@Activity, "Safe!", Toast.LENGTH_SHORT).show()}

// 需要 Context 但不确定是否 Activity 时
public static void safeStartActivity(Context context, Intent intent) {if (context instanceof Activity) {context.startActivity(intent);
    } else {intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
        context.startActivity(intent);
    }
}

// 错误做法：可能发生在 Activity 销毁后
view.post {Toast.makeText(context, "Loaded", Toast.LENGTH_SHORT).show() // 风险!}

// 正确做法：view.post {if (view.context is Activity) {
        val activity = view.context as Activity
        if (!activity.isDestroyed) {Toast.makeText(activity, "Safe", Toast.LENGTH_SHORT).show()}
    }
}