Android Hilt应用插桩测试报错：Cannot mix test roots with non-test roots

这个问题我之前帮开发者排查过好几次，核心原因是你的测试环境同时加载了主应用的MyApplication（属于主代码根目录，非测试根）和Hilt测试类（属于测试根目录），而Hilt不允许这种跨根的混合引用——尤其是你通过自定义MyAppRunner强制替换应用为HiltTestApplication，但主Manifest里的MyApplication仍然被合并到测试环境中，导致冲突。

下面给你两种靠谱的解决方案，根据你的需求选就行：

方案1：移除自定义测试运行器，用默认Hilt测试配置 #

这是最简洁的方案，适合大多数不需要自定义测试应用的场景：

• 直接删掉你的MyAppRunner类，@HiltAndroidTest注解会自动帮你处理测试应用的创建，完全不需要手动替换。
• 保持你的测试类代码不变（已经是正确的Hilt测试模式）：

@RunWith(AndroidJUnit4.class)
@HiltAndroidTest
class MyTest {
    @Rule
    public HiltAndroidRule hiltRule = new HiltAndroidRule(this);
    @Inject
    SomeStuff stuff;

    @Before
    public void setUp() {
        hiltRule.inject();
    }

    // 你的测试方法
}

• 此时Hilt会自动生成测试专用的应用类，不会和主应用的MyApplication产生冲突，编译错误自然就消失了。

方案2：自定义测试应用（适合需要添加测试专属配置的场景） #

如果你确实需要在测试时使用自定义的应用类（比如添加测试专用的依赖或初始化逻辑），不要直接用HiltTestApplication，而是通过@CustomTestApplication来生成兼容的测试应用：

1. 抽离主应用基类：把主应用MyApplication中共享的逻辑抽离到一个不带@HiltAndroidApp的基类中：

// 主代码目录下，例如com.my.application包
public class BaseApplication extends Application {
    // 这里放主应用和测试应用共享的初始化逻辑、工具方法等
}

2. 修改主应用类：让MyApplication继承基类并保留@HiltAndroidApp注解：

@HiltAndroidApp
public class MyApplication extends BaseApplication {
    // 主应用专属的配置和逻辑
}

3. 创建测试应用注解：在测试代码目录下，创建一个空接口并添加@CustomTestApplication注解，指向刚才的基类：

// 测试代码目录下，例如com.my.test包
@CustomTestApplication(BaseApplication.class)
public interface TestMyApplication {
    // 空接口即可，Hilt会自动生成对应的测试应用类TestMyApplication_Application
}

4. 保持测试类不变：你的现有测试类不需要任何修改，@HiltAndroidTest会自动使用生成的测试应用类，彻底避免和主应用MyApplication的冲突。

关键注意事项 #

• 绝对不要在测试环境中同时引用主应用的@HiltAndroidApp类和测试用的Hilt应用类，这是触发错误的核心原因。
• @CustomTestApplication必须配合不带@HiltAndroidApp的基类使用，因为@HiltAndroidApp会生成主应用的DI组件，而@CustomTestApplication会生成测试用的DI组件，两者不能共存于同一个类上。
• 确保你的build.gradle中已经添加了Hilt测试依赖：

androidTestImplementation "com.google.dagger:hilt-android-testing:2.44"
kaptAndroidTest "com.google.dagger:hilt-android-compiler:2.44"

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