Android Espresso测试中如何断言操作触发的异常？

我之前也踩过这个坑！Espresso为了提供更详细的UI调试信息，确实会把操作中抛出的原始异常包装成PerformException，这直接导致我们没法直接断言原始异常的类型和信息。不过别担心，有几个实用的办法可以解决这个问题：

方法1：全局设置FailureHandler捕获原始异常 #

你可以在测试的初始化阶段设置自定义的FailureHandler，让它自动解开PerformException的包装，直接抛出原始异常。这样所有测试用例里的异常都会以原始形态暴露出来，方便你做断言。

比如在测试类的@Before方法里添加：

@Before
fun setupEspressoFailureHandler() {
    Espresso.setFailureHandler { error, _ ->
        // 尝试从PerformException中获取原始异常，否则直接用原错误
        val originalException = (error as? PerformException)?.cause ?: error
        // 抛出原始异常，让测试框架捕获并判定失败
        throw originalException
    }
}

之后在测试用例里，你就可以直接用assertThrows来断言预期的异常了：

@Test
fun testButtonClickThrowsCustomException() {
    val expectedException = assertThrows<YourCustomException> {
        onView(withId(R.id.your_target_button)).perform(ViewActions.click())
    }
    // 进一步验证异常的细节
    assertEquals("Expected error message here", expectedException.message)
}

方法2：针对单个测试用例捕获并解析PerformException #

如果不想全局修改FailureHandler，也可以在单个测试里直接捕获PerformException，然后提取它的cause（也就是原始异常）来做断言：

@Test
fun testSpecificActionThrowsException() {
    try {
        // 执行会触发异常的UI操作
        onView(withId(R.id.problematic_view)).perform(ViewActions.click())
        // 如果没有抛出异常，手动标记测试失败
        fail("Expected YourCustomException but no exception was thrown")
    } catch (performEx: PerformException) {
        // 获取原始异常
        val originalException = performEx.cause
        // 断言原始异常的类型和信息
        assertThat(originalException, instanceOf(YourCustomException::class.java))
        assertThat(originalException?.message, equalTo("Expected error content"))
    }
}

方法3：自定义ViewAction直接抛出原始异常 #

如果只是针对某个特定的UI操作（比如点击、输入），你可以自定义一个ViewAction，在执行操作时直接捕获并抛出原始异常，绕过Espresso的包装逻辑：

// 自定义一个点击Action，直接抛出原始异常
fun clickAndExposeOriginalException(): ViewAction {
    return object : ViewAction {
        override fun getConstraints(): Matcher<View> = isClickable()

        override fun getDescription(): String = "click view and expose original exception"

        override fun perform(uiController: UiController, view: View) {
            try {
                // 执行点击操作
                view.performClick()
            } catch (e: Exception) {
                // 直接抛出原始异常，不经过Espresso包装
                throw e
            }
        }
    }
}

然后在测试里使用这个自定义Action：

@Test
fun testCustomActionThrowsException() {
    val exception = assertThrows<YourCustomException> {
        onView(withId(R.id.your_button)).perform(clickAndExposeOriginalException())
    }
    assertEquals("Expected error message", exception.message)
}

为什么Espresso会这么做？ #

简单说，Espresso的设计是为了在UI测试失败时提供尽可能多的上下文信息——比如当前匹配的View是什么、UI线程的状态等，所以它会把操作中的异常包装成PerformException，附加这些调试信息。但这确实给我们断言原始异常带来了麻烦，上面的方法就是用来绕过或者解开这个包装的。

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