Hilt Instrumentation测试报错：自定义测试应用未被识别，提示无法使用@HiltAndroidApp应用的问题求助

兄弟我之前踩过一模一样的Hilt测试坑，简直头大！让我帮你捋捋问题出在哪，怎么一步步解决：

首先，你的核心问题是测试环境还是在加载正式的AppApplication（带@HiltAndroidApp注解），而Hilt的Instrumentation测试绝对不允许用正式的Hilt App，必须用测试专属的应用类。你虽然在测试类里定义了@CustomTestApplication，但有几个关键配置没跟上，导致Hilt没识别到你的测试应用。

问题根源拆解 #

你正式的AndroidManifest.xml里明确指定了android:name=".AppApplication"，如果测试包下的AndroidManifest.xml没有覆盖这个配置，系统启动测试时还是会加载正式的AppApplication，这就触发了Hilt的报错逻辑——它检测到你用了正式的@HiltAndroidApp应用，直接给你拦下来。

一步步解决步骤 #

1. 给测试环境单独写Manifest，覆盖正式的应用类配置

在src/androidTest/目录下创建AndroidManifest.xml（如果还没有的话），内容如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="你的项目包名"> <!-- 这里要和正式包名一致 -->

    <application
        tools:replace="android:name" <!-- 关键：覆盖正式Manifest里的application name -->
        android:name=""/> <!-- 留空，让Hilt自动用测试生成的应用类 -->
    </application>
</manifest>

这一步是核心！必须让测试环境不要加载正式的AppApplication。

2. 把@CustomTestApplication的定义移到测试包的顶层，别放在测试类内部

之前你把TestApplication接口定义在Buying测试类内部，有些版本的Hilt注解处理器会扫描不到这个定义。建议单独抽出来：
在src/androidTest/java/你的包名/下新建一个TestApp.kt文件，内容：

import dagger.hilt.android.testing.CustomTestApplication

@CustomTestApplication(MyApplication::class)
interface TestApplication

这样Hilt的注解处理器能更稳定地生成测试用的应用类。

3. 调整测试类的注解配置，去掉多余的Runner声明

@HiltAndroidTest注解已经自带了Hilt的测试Runner，不需要再加@RunWith(AndroidJUnit4::class)了，反而可能冲突。修改后的测试类开头应该是这样：

@LargeTest
@HiltAndroidTest
class Buying {

    // 你要注入的依赖
    @Inject
    lateinit var yourNeededClass: YourNeededClass

    // ... 你的测试代码
}

4. 强制清理重构项目，避免注解处理器缓存坑

Hilt的注解处理器有时候会抽风，生成的代码没更新。直接去Android Studio的Build菜单，先点Clean Project，再点Rebuild Project，把旧的生成代码清干净。

额外注意点 #

• 确保你的MyApplication基类是纯抽象类/普通类，绝对不能带@HiltAndroidApp注解，这点你已经做对了，继续保持。
• 检查你的Hilt测试依赖是否齐全，build.gradle（Module级）里要加这两行（版本和你用的hilt-android版本一致）：

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

按上面的步骤走一遍，应该就能解决这个报错了。我当初就是因为没覆盖测试的Manifest，折腾了大半天，现在想想都是泪😂

内容来源于stack exchange