使用Hilt与Room实现UserViewModel存储用户信息时实例化报错解决

问题概述 #

我正在实现一个集成Hilt依赖注入的UserViewModel，目标是在Compose按钮点击时将用户名、邮箱等信息存入Room数据库。状态已提升至UserProfileState组件，但在该组件中创建ViewModel时应用崩溃，核心报错为：

java.lang.RuntimeException: Cannot create an instance of class com.example.myApp2022.userviewmodel.UserViewModel

错误日志显示系统尝试用无参构造创建ViewModel，但我的UserViewModel带有UserRepository参数，且已标记@HiltViewModel注解。

核心原因 #

使用了Compose默认的viewModel<UserViewModel>()方法实例化ViewModel，该方法不会触发Hilt的依赖注入逻辑，系统只能尝试调用无参构造，导致失败。

解决步骤 #

1. 确认Hilt基础配置完成 #

• 应用入口类添加@HiltAndroidApp注解，作为Hilt的全局依赖容器
• 承载Compose的Activity添加@AndroidEntryPoint注解，让Hilt能为Activity及其子组件提供依赖
• 确保项目已添加Hilt和Hilt-Compose的相关依赖

2. 使用Hilt专属的ViewModel实例化方法 #

在Compose组件中，必须用Hilt提供的hiltViewModel()替代默认的viewModel()，才能让Hilt正确注入UserRepository依赖。

3. 正确传递ViewModel到子Composable #

在父组件中获取ViewModel实例后，直接传递给子组件，避免重复实例化。

4. 确保UserRepository可被Hilt注入 #

UserRepository的构造函数需添加@Inject注解，或者在Hilt模块中通过@Provides方法提供实例。

修正后的代码示例 #

修正UserProfileState组件 #

@Composable
fun UserProfileState() {
    // 使用hiltViewModel()替代默认的viewModel()
    val viewModel: UserViewModel = hiltViewModel()
    var username by rememberSaveable { mutableStateOf("") }
    var email by rememberSaveable { mutableStateOf("") }

    UserProfile(
        username = username,
        onUsernameChange = { username = it },
        email = email,
        onEmailChange = { email = it },
        viewModel = viewModel // 将ViewModel传递给子组件
    )
}

修正按钮点击逻辑（修复拼写错误） #

Button(
    colors = ButtonDefaults.buttonColors(backgroundColor = LightBlue),
    modifier = Modifier.size(160.dp, 50.dp),
    onClick = { 
        val userInfo = Users(id = UUID.randomUUID(), username, email)
        viewModel.addUser(userInfo) // 修正方法名拼写错误（原addUsers改为addUser）
    },
) {
    Text(
        text = "Save Info",
        color = Color.White,
        fontWeight = FontWeight.Bold,
        fontSize = 15.sp
    )
}

确认UserRepository的注入配置 #

// 给UserRepository的构造函数添加@Inject注解，让Hilt可以注入依赖
class UserRepository @Inject constructor(
    private val userDao: UserDao
) {
    suspend fun addUser(users: Users) {
        // Room数据库插入逻辑
        userDao.insertUser(users)
    }

    // 其他CRUD方法...
}

应用类与Activity配置示例 #

// 应用入口类
@HiltAndroidApp
class MyApp2022 : Application()

// 承载Compose的Activity
@AndroidEntryPoint
class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MyApp2022Theme {
                // NavHost或其他Compose内容
                UserProfileState()
            }
        }
    }
}

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