Android Kotlin中@BeforeClass内assertNotNull致测试套件为空问题

这个坑我之前踩过！其实核心原因是Android Instrumented Test（也就是你用的androidTest目录下的测试）的JUnit运行机制和普通JUnit桌面测试不一样，导致@BeforeClass阶段调用断言方法会破坏测试套件的初始化流程。

为什么会出现「Empty test suite」？ #

1. 执行时机的问题：@BeforeClass修饰的静态方法是在测试类被加载时就执行的，这时候Android测试框架还没完全初始化好断言所需的上下文环境。
2. 断言方法的特殊性：Android测试库提供的assertNotNull()这类断言方法，依赖于测试框架的错误收集机制。在@BeforeClass阶段调用它时，抛出的AssertionError没有被测试框架正确捕获，反而直接导致整个测试类被标记为「无效」，最终测试套件就显示为空了。
3. 日志能打印的原因：因为你是先打印日志再调用断言，所以日志会正常输出，但断言抛出的异常打断了后续的测试初始化流程。

而@Test方法里的断言能正常工作，是因为@Test方法是在测试框架完全初始化完成后才执行的，此时断言的上下文已经准备就绪，抛出的异常会被框架正确捕获，标记为测试失败而非整个套件失效。

解决办法 #

针对这个问题，有两种常用的解决思路：

1. 把断言移到@Before方法中

@Before方法是每个测试方法执行前都会运行的，此时测试环境已经完全初始化，断言可以正常工作：

class YourTestClass {
    @Before
    fun setup() {
        println("+++ +++ initBeforeEachTest()")
        assertNotNull(yourObject)
    }

    @Test
    fun testSomething() {
        // 你的测试逻辑
    }
}

2. 用普通异常替代断言（如果必须在类初始化阶段检查）

如果你确实需要在@BeforeClass阶段做前置检查，可以不用Android测试库的断言方法，改用普通的判断+抛出运行时异常，这样测试框架会捕获到异常并标记测试失败，而不是直接清空测试套件：

class YourTestClass {
    companion object {
        @JvmStatic
        @BeforeClass
        fun initBeforeTest() {
            println("+++ +++ initBeforeTest()")
            val yourObject = getYourObject()
            if (yourObject == null) {
                throw RuntimeException("YourObject must not be null before tests start")
            }
        }
    }

    @Test
    fun testSomething() {
        // 你的测试逻辑
    }
}

额外建议 #

你当前用的是旧版的Android Support测试库，建议升级到AndroidX的测试库，兼容性和稳定性更好：

androidTestImplementation 'androidx.test:runner:1.5.2'
testImplementation 'junit:junit:4.13.2'

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