使用JUnit5进行单元测试时遇android.os.Looper.getMainLooper未模拟的RuntimeException问题如何解决？

嘿，这个问题我之前做Android单元测试的时候也踩过坑！本质原因是咱们在本地跑JUnit5测试时，Android SDK里的很多核心类（比如Looper）并没有真实实现，只是空壳方法，调用就会抛出这种未模拟的异常。下面给你几个实用的解决思路：

方法一：让未模拟的Android方法返回默认值 #

这是最简单快速的方案，适合测试逻辑不依赖这些方法真实行为的场景。你只需要在app模块的build.gradle（或build.gradle.kts）里添加配置：

Groovy DSL 配置： #

android {
    testOptions {
        unitTests.returnDefaultValues = true
    }
}

Kotlin DSL 配置： #

android {
    testOptions {
        unitTests.returnDefaultValues = true
    }
}

这个配置会让所有未被模拟的Android SDK方法返回默认值（比如null、0或者false），直接绕过异常。但要注意，如果你的测试逻辑需要依赖Looper.getMainLooper()的真实行为，这个方案可能会导致测试结果不准确。

方法二：用Robolectric模拟完整Android环境 #

如果需要更贴近真实设备的测试行为，Robolectric是最佳选择——它能在JVM上模拟Android框架的大部分核心类，包括Looper，不用依赖真实设备或模拟器。

步骤1：添加Robolectric依赖 #

在build.gradle（或build.gradle.kts）中加入依赖：

Groovy DSL：

testImplementation 'org.robolectric:robolectric:4.12.1'
testImplementation 'org.robolectric:robolectric-junit5:4.12.1' // 适配JUnit5的扩展

Kotlin DSL：

testImplementation("org.robolectric:robolectric:4.12.1")
testImplementation("org.robolectric:robolectric-junit5:4.12.1")

步骤2：在测试类中启用Robolectric #

在你的JUnit5测试类上添加扩展注解：

import org.junit.jupiter.api.extension.ExtendWith;
import org.robolectric.RobolectricExtension;

@ExtendWith(RobolectricExtension.class)
public class YourTestClass {
    // 你的测试方法...
}

这样Robolectric就会自动为你模拟Looper.getMainLooper()的真实行为，测试逻辑的准确性会高很多。

方法三：手动用Mockito Mock Looper类 #

如果不想引入Robolectric，或者有自定义mock的需求，可以用Mockito来手动模拟Looper类：

步骤1：添加Mockito依赖 #

testImplementation 'org.mockito:mockito-core:5.6.0'
testImplementation 'org.mockito:mockito-inline:5.6.0' // 用于mock final类（Looper是final类）

步骤2：在测试中Mock Looper #

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import static org.mockito.Mockito.when;

@ExtendWith(MockitoExtension.class)
public class YourTestClass {

    @Mock
    private Looper mockLooper;

    @BeforeEach
    void setUp() {
        // 指定调用Looper.getMainLooper()时返回我们mock的对象
        when(Looper.getMainLooper()).thenReturn(mockLooper);
    }

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

这种方式灵活性很高，但需要注意：如果后续代码中还有依赖Looper其他方法的调用，你可能需要额外mock这些方法的行为，否则还是会出问题。

总结一下：简单场景用方法一，追求真实环境用方法二，有自定义需求用方法三，根据你的测试场景选就行啦！

备注：内容来源于stack exchange，提问作者Mona Baharlou