Android Handler结合自定义Toast异常及双层Handler生效原因咨询

需求为显示自定义Toast后立即finish当前Activity，但使用Handler(Looper.getMainLooper()).post { ... }包裹自定义Toast逻辑时，单层Handler无法正常显示Toast，双层Handler却能正常运行，需了解底层机制及忽略的关键点。

相关资源 #

custom_toast.xml #

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="vertical" >

    <TextView
        android:id="@+id/tv_test_toast"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:background="@drawable/ctm_bg_toast"
        android:gravity="center"
        android:padding="10dp"
        android:text="TextView"
        android:textColor="#FFFFFF"
        android:textSize="14dp" />

</LinearLayout>

ctm_bg_toast.xml #

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
    android:shape="rectangle">
    <solid android:color="#99000000"/>
    <corners android:radius="100dp"/>
    <padding android:left="10dp" android:top="7dp" android:right="10dp" android:bottom="7dp"/>
</shape>

代码片段 #

1. 单层Handler实现 #

class TestActivity: AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        Handler(Looper.getMainLooper()).post {
            val toast = Toast(this@TestActivity)
            toast.view = View.inflate(this@TestActivity, R.layout.custom_toast, null)
            ((toast.view?.findViewById(R.id.tv_test_toast)) as TextView).text = "test message"
            toast.setGravity(Gravity.CENTER, 0, Toast.LENGTH_SHORT)
            toast.show()
        }
        finish()
    }
}

该代码无法显示自定义Toast，核心原因是Handler异步执行时Activity已进入销毁流程。

2. 双层Handler实现 #

class TestActivity: AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        Handler(Looper.getMainLooper()).post {
            Handler(Looper.getMainLooper()).post {
                val toast = Toast(this@TestActivity)
                toast.view = View.inflate(this@TestActivity, R.layout.custom_toast, null)
                ((toast.view?.findViewById(R.id.tv_test_toast)) as TextView).text = "test message"
                toast.setGravity(Gravity.CENTER, 0, Toast.LENGTH_SHORT)
                toast.show()
            }
        }
        finish()
    }
}

该代码可正常显示自定义Toast。

问题分析与原理说明 #

1. 单层Handler失效的核心原因 #

在onCreate中调用Handler.post(Runnable)时，该Runnable会被加入主线程消息队列的尾部；紧接着finish()会触发系统向消息队列中插入Activity销毁相关的生命周期消息（如触发onStop、onDestroy）。当主线程处理到Toast逻辑的Runnable时，Activity已进入销毁流程：其关联的Window已被标记为待销毁，此时用Activity Context创建的自定义Toast View无法被WindowManager正常添加显示，最终导致Toast无法呈现。

2. 双层Handler生效的底层逻辑 #

双层post本质是将Toast逻辑的Runnable推到了消息队列的最尾部，执行顺序如下：

• 第一层Runnable被加入队列，排在onCreate消息之后、Activity销毁消息之前。
• 主线程执行第一层Runnable时，内部再次post第二层Runnable，此时第二层Runnable会被追加到队列的最末尾，排在所有Activity销毁消息之后。
• 主线程先处理第一层Runnable，接着执行Activity销毁消息（完成onStop、onDestroy等生命周期回调），最后执行第二层Runnable。
• 虽然此时Activity已销毁，但Toast是依附于系统全局Window的独立组件，只要代码中持有的Activity Context未被GC回收（短时间内不会被回收），WindowManager就能正常添加Toast View并完成显示。

3. 被忽略的关键点 #

• Toast的显示不依赖Activity的存活状态，但自定义Toast的View若使用Activity Context创建，需保证Context在Toast显示周期内未被回收。
• 主线程消息队列的执行顺序直接决定代码行为：post的Runnable按加入顺序执行，finish()触发的销毁消息会插入队列，单层与双层post的核心区别是Toast逻辑在队列中的位置。

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