Android Compose中Hilt插桩测试传参ViewModel注入失败原因咨询

代码背景 #

ViewModel采用Hilt注入实现：

class PrimaryViewModel @Inject constructor(
    private val jokeRepository: JokeRepository
) : ViewModel() {
    ...
}

正常工作的写法 #

以下实现无论生产环境还是插桩测试都能正常运行：

import androidx.lifecycle.viewmodel.compose.viewModel
...
@Composable
fun PrimaryScreen() {
    val viewModel: PrimaryViewModel = viewModel()                // 始终正常

    ...
}

测试失败的写法 #

将ViewModel作为Composable默认参数时，生产代码正常，但插桩测试直接报错：

@Composable
fun PrimaryScreen(viewModel: PrimaryViewModel = viewModel()) {    // 测试失败
    ...
}

测试配置（最初失败版本） #

Hilt测试替换模块：

// app/src/androidTest/java/com/example/jokes/testdi/TestDataModule.kt
@Module
@TestInstallIn(
    components = [SingletonComponent::class],
    replaces = [DataModule::class]
)
interface FakeDataModule {

    @Binds
    fun bindRepository(
        fakeRepository: FakeJokeRepository
    ): JokeRepository
...
}

测试类代码：

@RunWith(AndroidJUnit4::class)
@HiltAndroidTest
class PrimaryScreenTest {

    var hiltRule = HiltAndroidRule(this)
    val composeTestRule = createAndroidComposeRule<ComponentActivity>()

    @get:Rule
    val rule: RuleChain = RuleChain
        .outerRule(hiltRule)
        .around(composeTestRule)

    @Before
    fun setup() {
        hiltRule.inject()
        composeTestRule.setContent { 
            PrimaryScreen()
        }
    }
}

报错信息 #

java.lang.RuntimeException: Cannot create an instance of class com.example.jokes.ui.joke.PrimaryViewModel
    ...
Caused by: java.lang.NoSuchMethodException: com.example.jokes.ui.joke.PrimaryViewModel.<init> []

核心疑问 #

为何使用ComponentActivity搭配composeTestRule.setContent会触发测试失败？和使用MainActivity+composeTestRule.activity.setContent的差异在哪？

1. Hilt对Activity的接管差异 #

你的MainActivity应该是添加了@AndroidEntryPoint注解的Hilt注入宿主，而ComponentActivity是未经过Hilt处理的基础Activity类：

• 用createAndroidComposeRule<MainActivity>()时，Hilt会通过@HiltAndroidTest和HiltRule完成对MainActivity的依赖注入初始化，Activity内部的ViewModelProvider会绑定Hilt的专属工厂，能正确识别@Inject构造函数创建PrimaryViewModel。
• 直接用ComponentActivity时，这个Activity完全没被Hilt接管，内部ViewModelProvider使用默认工厂，只会尝试调用ViewModel的无参构造方法，而你的PrimaryViewModel只有带参数的@Inject构造，自然抛出NoSuchMethodException。

2. 两种setContent写法的本质区别 #

• composeTestRule.activity.setContent：基于已经初始化完成的Activity实例（这里是Hilt处理过的MainActivity）设置Compose内容，此时Activity的Context已经关联Hilt依赖容器，ViewModel创建会走Hilt的工厂流程。
• composeTestRule.setContent（直接调用）：当泛型是ComponentActivity时，这个方法会新建一个未经过Hilt初始化的ComponentActivity实例来承载Compose内容，完全脱离了测试类中HiltRule的注入流程，ViewModel根本拿不到依赖。

3. 默认参数写法的特殊触发逻辑 #

当ViewModel作为Composable默认参数时，viewModel()的调用时机是在Composable初始化阶段，且完全依赖当前Composable所在Activity的ViewModelProvider。如果承载Compose的Activity没被Hilt正确初始化，这个默认参数的viewModel()调用就会用默认工厂，直接创建失败。

而第一种在Composable内部直接调用viewModel()的写法，本质依赖同样的ViewModelProvider，但只要测试用的是Hilt处理过的Activity，就能正常工作——这也是换成MainActivity+activity.setContent后测试恢复正常的核心原因。

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