Android Jetpack Compose测试：如何验证Toast消息是否弹出？

问题原因 #

Toast属于系统级弹窗，Espresso默认的视图匹配器只能查找当前Activity内的控件，无法直接捕获Toast，这是你用onNodeWithText验证失败的核心原因。

解决方案 #

方法一：自定义Root匹配器捕获Toast

通过自定义RootMatcher识别Toast所在的系统窗口，代码如下：

1. 实现Toast根视图匹配器：

import android.view.WindowManager
import androidx.test.espresso.matcher.RootMatchers
import org.hamcrest.Description
import org.hamcrest.TypeSafeMatcher

fun isToast(): TypeSafeMatcher<Root> {
    return object : TypeSafeMatcher<Root>() {
        override fun matchesSafely(root: Root): Boolean {
            val windowAttrs = root.decorView.windowAttributes
            return windowAttrs.type == WindowManager.LayoutParams.TYPE_TOAST &&
                    windowAttrs.flags and WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE == WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE
        }

        override fun describeTo(description: Description) {
            description.appendText("匹配Toast窗口")
        }
    }
}

2. 修改验证代码：

onNodeWithTag(TestTag.OPEN_DRAWER_BUTTON).performClick()
onNodeWithTag(TestTag.SYNCHRONIZE_BUTTON).performClick()

// 使用自定义匹配器验证Toast
onView(withText(R.string.success_update))
    .inRoot(isToast())
    .check(matches(isDisplayed()))

方法二：使用UiAutomator捕获系统级Toast

如果自定义匹配器无效，可借助UiAutomator访问系统控件：

1. 确保添加UiAutomator依赖（在build.gradle中）：

androidTestImplementation 'androidx.test.uiautomator:uiautomator:2.2.0'

2. 编写验证逻辑：

import androidx.test.platform.app.InstrumentationRegistry
import androidx.test.uiautomator.UiDevice
import androidx.test.uiautomator.UiSelector

onNodeWithTag(TestTag.OPEN_DRAWER_BUTTON).performClick()
onNodeWithTag(TestTag.SYNCHRONIZE_BUTTON).performClick()

val device = UiDevice.getInstance(InstrumentationRegistry.getInstrumentation())
val targetToastText = activity.getString(R.string.success_update)
// 等待Toast出现（超时5秒）
val toastExists = device.findObject(UiSelector().text(targetToastText)).waitForExists(5000)
assertTrue(toastExists)

注意事项 #

• 确认R.string.success_update的文本值和实际弹出的Toast文本完全一致，避免因文本不匹配导致验证失败
• 操作后给Toast足够的显示时间，可通过Thread.sleep(500)或Espresso的IdlingResource处理异步操作，确保Toast已加载完成再执行验证

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