Android测试疑惑：Espresso主线程报错，CoroutineScope方案为何有效？

问题背景 #

测试自定义CaptionsView时遇到以下问题：

1. 初始测试流程：通过SharedPreferences设置字幕背景色 → 调用updateCaptionStyle()更新视图 → 用Espresso的onView(...).check(...)断言背景色，结果断言失败，推测是Espresso没有等待rule.scenario.onActivity{}中的代码执行完成就开始断言。
2. 将check代码移入onActivity作用域后，触发异常：

java.lang.IllegalStateException: Method cannot be called on the main application thread (on: main)
at androidx.test.internal.util.Checks.checkState(Checks.java:111)
at androidx.test.internal.util.Checks$1.checkNotMainThread(Checks.java:150)
at androidx.test.internal.util.Checks.checkNotMainThread(Checks.java:130)
at androidx.test.espresso.ViewInteraction.postAsynchronouslyOnUiThread(ViewInteraction.java:1)
at androidx.test.espresso.ViewInteraction.check(ViewInteraction.java:5)
at ...** 

3. 尝试过runBlockingTest、runOnUiThread、@UiThreadTest、view.doOnLayout{}等方案均无效，仅将check代码放入CoroutineScope(Dispatchers.Default)的launch块中可行，对应测试代码如下：

@RunWith(AndroidJUnit4::class)
@ExperimentalCoroutinesApi
class SessionActivityTest {

    private val sharedPrefs: SharedPreferences by inject(SharedPreferences::class.java)

    private val intent: Intent by lazy {
        val intent =
            Intent(ApplicationProvider.getApplicationContext(), SessionActivity::class.java)
        intent.putExtra(Constants.SESSION_ID_KEY, UUID.randomUUID().toString())
    }

    private val testScope = CoroutineScope(Dispatchers.Default)

    @get:Rule
    var rule = ActivityScenarioRule<SessionActivity>(intent)


    @Test
    fun сaptionView_changeBackgroundColor() {

        rule.scenario.onActivity {
            sharedPrefs.saveCaptionViewSettings(CaptionSettingsModel(backgroundColor = R.color.caption_color_orange))
            it.updateCaptionStyle()

        }

        testScope.launch {
            onView(withId(R.id.caption_view)).check { view, _ ->
                if (view is CaptionsView) {
                    val actualBackgroundColor = view.captionsBackgroundColor
                    val expectedColor =
                        ContextCompat.getColor(
                            view.context,
                            R.color.caption_color_orange
                        )
                    assertThat(actualBackgroundColor, is(equalTo(expectedColor)))
                }
            }
        }
    }
}

方案有效原因解析 #

1. Espresso的线程硬性要求 #

Espresso的ViewInteraction.check()方法内部有严格的线程检查：必须在非主线程调用，源码里的checkNotMainThread()方法会直接阻断主线程的调用，而onActivity{}的代码是运行在主线程的，所以直接在里面调用check必然触发IllegalStateException。

2. Dispatchers.Default的线程调度特性 #

Dispatchers.Default会将协程调度到后台线程池（属于非主线程），完全满足Espresso对线程的要求，所以check方法能正常执行，不会触发线程异常。

3. 间接实现了同步等待 #

虽然你是在后台协程中调用check，但Espresso本身具备自动等待机制：它会等待主线程完成所有待处理任务（包括onActivity{}里的updateCaptionStyle()视图更新操作），直到界面进入稳定状态后才会执行断言逻辑。这就间接解决了最初“断言未等待onActivity代码执行完成”的问题。

为什么其他方案无效？ #

• runBlockingTest/runOnUiThread/@UiThreadTest：这些方法都是强制在主线程执行代码，完全违反了Espresso的线程约束，所以仍会触发同样的异常。
• view.doOnLayout{}：它的回调逻辑是在主线程执行的，同样不能直接调用Espresso的check方法，自然无法解决问题。

内容的提问来源于stack exchange，提问作者Xena Warrior Princess