Android Espresso基础测试触发AppNotIdleException问题求助

我来帮你排查这个困扰你的AppNotIdleException——这是Espresso测试里非常常见的问题，本质是你的应用在测试执行期间一直处于忙碌状态，Espresso等待了60秒都没等到应用回到空闲状态，所以触发了超时异常。下面一步步给你拆解解决方案：

1. 先移除不可靠的Thread.sleep() #

你测试代码里的Thread.sleep(10000)不仅完全不可靠（不同设备的加载速度差异很大），还可能掩盖真正的问题。Espresso本身会自动等待UI线程空闲，以及View的出现，所以直接删掉这段sleep代码，换成Espresso原生的等待逻辑：

修改后的测试方法可以简化成这样：

@Test
public void adviceDisplay2() {
    // 直接匹配目标按钮，Espresso会自动等待它出现并可交互
    onView(withId(R.id.third_button))
        .check(matches(isDisplayed()))
        .perform(click());

    // 验证目标TextView是否显示
    onView(withId(R.id.advice))
        .check(matches(isDisplayed()));
}

另外，你当前用了IntentsTestRule但没用到Intents相关功能，换成普通的ActivityTestRule可以减少不必要的初始化开销：

@Rule
public ActivityTestRule<SplashActivity> mActivityTestRule = new ActivityTestRule<>(SplashActivity.class);

2. 排查应用中的异步/后台操作 #

AppNotIdleException最常见的原因是应用里有Espresso无法自动检测到的异步任务，比如：

• SplashActivity里的网络请求（比如接口拉取初始化数据）
• 数据库读写操作
• 自定义的线程/Handler循环任务
• RxJava、Coroutine等异步流没有正确结束

你需要检查SplashActivity的逻辑：是不是有后台任务一直在运行，或者任务结束后没有正确通知UI线程？

3. 用IdlingResource让Espresso识别异步任务 #

如果你的应用有自定义的异步操作，Espresso默认是检测不到的，这时候需要注册IdlingResource来告诉Espresso“什么时候应用才算空闲”。

步骤1：创建CountingIdlingResource实现 #

public class AppIdlingResource implements IdlingResource {
    private final CountingIdlingResource internalResource;

    public AppIdlingResource(String resourceName) {
        internalResource = new CountingIdlingResource(resourceName);
    }

    // 异步任务开始时调用
    public void increment() {
        internalResource.increment();
    }

    // 异步任务结束时调用（成功/失败都要调用）
    public void decrement() {
        internalResource.decrement();
    }

    @Override
    public String getName() {
        return internalResource.getName();
    }

    @Override
    public boolean isIdleNow() {
        return internalResource.isIdleNow();
    }

    @Override
    public void registerIdleTransitionCallback(ResourceCallback callback) {
        internalResource.registerIdleTransitionCallback(callback);
    }
}

步骤2：在应用的异步任务中使用 #

比如在SplashActivity的网络请求逻辑里：

public class SplashActivity extends AppCompatActivity {
    private AppIdlingResource idlingResource;

    // 对外提供获取IdlingResource的方法
    public AppIdlingResource getIdlingResource() {
        if (idlingResource == null) {
            idlingResource = new AppIdlingResource("SplashInitResource");
        }
        return idlingResource;
    }

    private void fetchInitData() {
        // 任务开始，通知Espresso应用进入忙碌状态
        getIdlingResource().increment();
        
        // 模拟网络请求
        new Retrofit.Builder()
            ...
            .build()
            .create(ApiService.class)
            .getInitData()
            .enqueue(new Callback<InitData>() {
                @Override
                public void onResponse(Call<InitData> call, Response<InitData> response) {
                    // 任务结束，通知Espresso应用回到空闲状态
                    getIdlingResource().decrement();
                    // 后续UI逻辑
                }

                @Override
                public void onFailure(Call<InitData> call, Throwable t) {
                    // 失败也要通知，避免Espresso一直等待
                    getIdlingResource().decrement();
                }
            });
    }
}

步骤3：在测试中注册IdlingResource #

public class AdviceDisplay2 {
    @Rule
    public ActivityTestRule<SplashActivity> mActivityTestRule = new ActivityTestRule<>(SplashActivity.class);

    private AppIdlingResource idlingResource;

    @Before
    public void setUp() {
        // 获取应用中的IdlingResource实例
        SplashActivity activity = mActivityTestRule.getActivity();
        idlingResource = activity.getIdlingResource();
        // 注册给Espresso
        Espresso.registerIdlingResources(idlingResource);
    }

    @After
    public void tearDown() {
        // 测试结束后注销，避免内存泄漏
        if (idlingResource != null) {
            Espresso.unregisterIdlingResources(idlingResource);
        }
    }

    // ... 你的测试方法
}

4. 检查其他可能的原因 #

• UI线程阻塞：如果应用里有在UI线程执行的耗时操作（比如大量计算），会导致Espresso认为应用一直忙碌，要把这些操作移到后台线程。
• 匹配器过于复杂：你之前的匹配器用了多层childAtPosition，虽然逻辑没问题，但简化成直接用withId可以减少匹配时间，也更容易排查问题。

按照上面的步骤一步步排查，应该就能解决这个AppNotIdleException问题了。

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