如何解决Espresso测试偶发AmbiguousViewMatcherException问题？

问题现象 #

Espresso测试每10至20次就会失败一次，失败时抛出AmbiguousViewMatcherException异常。

根因分析 #

排查后发现，问题出在轮播图切换的瞬间：Espresso偶尔会在两张幻灯片各显示一半的状态下执行View匹配操作，此时界面中会同时存在两个ID相同的View，导致匹配歧义。

不理想的临时方案 #

一开始尝试给Matcher添加额外匹配条件，比如限定它是显示特定文本的View的同级控件，但这个方案有明显缺陷：

• 操作繁琐：同一幻灯片需要检查多个View时，每个Matcher都要重复添加关联条件
• 缺乏灵活性：如果代码其他位置出现同类问题，得逐个修改所有相关Matcher，维护成本高

标准解决方案：使用IdlingResource #

IdlingResource是Espresso解决不稳定测试的标准方案，它能确保所有界面元素完全稳定后，再执行Matcher操作，从根源上避免这类因界面状态未稳定导致的匹配错误。

实现示例 #

1. 自定义IdlingResource监听轮播状态

创建一个自定义的IdlingResource，用来监听轮播图的切换状态，只有当轮播完全停止、当前页面完全显示时，才标记为Idle状态：

class CarouselIdlingResource(private val carousel: ViewPager2) : IdlingResource {
    private var callback: IdlingResource.ResourceCallback? = null

    override fun getName(): String = "CarouselIdlingResource"

    override fun isIdleNow(): Boolean {
        // 判断轮播是否处于稳定状态：无滚动动画且处于空闲状态
        val isIdle = !carousel.isFakeDragging && carousel.scrollState == ViewPager2.SCROLL_STATE_IDLE
        if (isIdle) {
            callback?.onTransitionToIdle()
        }
        return isIdle
    }

    override fun registerIdleTransitionCallback(callback: IdlingResource.ResourceCallback?) {
        this.callback = callback
    }
}

2. 在测试中注册和注销IdlingResource

在测试类的初始化和清理阶段，完成IdlingResource的注册与注销，确保测试过程中Espresso能感知轮播状态：

@Rule
@JvmField
val activityScenarioRule = ActivityScenarioRule(MainActivity::class.java)

private lateinit var carouselIdlingResource: CarouselIdlingResource

@Before
fun setUp() {
    activityScenarioRule.scenario.onActivity { activity ->
        val carousel = activity.findViewById<ViewPager2>(R.id.carousel)
        carouselIdlingResource = CarouselIdlingResource(carousel)
        IdlingRegistry.getInstance().register(carouselIdlingResource)
    }
}

@After
fun tearDown() {
    IdlingRegistry.getInstance().unregister(carouselIdlingResource)
}

3. 编写稳定的测试用例

之后正常编写Espresso测试用例即可，此时Espresso会自动等待轮播状态稳定后，再执行View匹配操作：

@Test
fun testCarouselContent() {
    // 验证第一张幻灯片的标题
    onView(withId(R.id.slide_title)).check(matches(withText("首页幻灯片")))
    
    // 模拟滑动到下一张
    onView(withId(R.id.carousel)).perform(swipeLeft())
    
    // 验证第二张幻灯片的标题
    onView(withId(R.id.slide_title)).check(matches(withText("推荐内容")))
}

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