Espresso使用first(Matcher)：从歧义异常转为无匹配视图异常

核心原因：Espresso多轮视图遍历导致匹配器状态失效 #

你实现的first匹配器用实例变量isFirst控制仅匹配第一个视图，但Espresso的视图匹配流程并非单次遍历层级，而是会执行多轮扫描：

1. 第一轮：预扫描所有视图，统计匹配数量（用于判断是否存在歧义或匹配项）
2. 第二轮：实际查找并返回目标视图

第一轮预扫描时，isFirst会被设为false，等到第二轮真正匹配时，所有视图的matches调用都会返回false，最终触发NoMatchingViewException。你日志中看到目标视图经过函数但未被识别，就是因为第一次遍历它时isFirst为true并返回了true，但这只是预扫描步骤；等到第二次遍历，isFirst已经是false，自然不会再匹配。

至于之前正常现在失效，大概率是你升级了Espresso依赖版本，新版本的匹配流程新增了预扫描步骤，导致旧的first匹配器逻辑不再兼容。

修正方案 #

方案1：改用Espresso官方定位方式（推荐） #

针对ListView/RecyclerView的列表项，优先使用官方提供的API，避免自定义匹配器的兼容性问题：

// ListView场景：定位第一个匹配的列表项
onData(allOf(is(instanceOf(Map.class)), hasEntry(equalTo("text"), is("text"))))
    .atPosition(0);

如果是RecyclerView，可使用RecyclerViewActions：

onView(withId(R.id.list))
    .perform(RecyclerViewActions.actionOnItemAtPosition(0, click()));

方案2：修复自定义first匹配器的状态问题 #

修改匹配器逻辑，用线程本地变量或原子计数器跟踪匹配状态，避免跨轮次的状态污染：

public static <T> Matcher<T> first(final Matcher<T> matcher) {
    return new BaseMatcher<T>() {
        private final ThreadLocal<Boolean> isFirst = ThreadLocal.withInitial(() -> true);

        @Override
        public boolean matches(final Object item) {
            Boolean firstFlag = isFirst.get();
            if (firstFlag && matcher.matches(item)) {
                isFirst.set(false);
                return true;
            }
            return false;
        }

        @Override
        public void describeTo(final Description description) {
            description.appendText("first matching item: ");
            matcher.describeTo(description);
        }
    };
}

或者用原子计数器实现：

public static <T> Matcher<T> first(final Matcher<T> matcher) {
    return new BaseMatcher<T>() {
        private final AtomicInteger matchCount = new AtomicInteger(0);

        @Override
        public boolean matches(final Object item) {
            return matcher.matches(item) && matchCount.getAndIncrement() == 0;
        }

        @Override
        public void describeTo(final Description description) {
            description.appendText("first matching item: ");
            matcher.describeTo(description);
        }
    };
}

额外注意点 #

• 避免依赖Espresso内部遍历逻辑，官方API会随版本更新保持兼容性，自定义匹配器容易因版本升级失效
• 若必须使用自定义匹配器，测试时需覆盖多轮匹配场景，确保状态不会跨轮次污染

内容的提问来源于stack exchange，提问作者K2-XT