Android Jetpack Compose：Hilt ViewModel无参构造函数崩溃求助

问题核心 #

这个崩溃的直接原因是：Jetpack ViewModel体系默认要求ViewModel类必须具备无参构造函数。如果你的DishesViewModel为了API调用添加了带参数的构造（比如注入Repository），直接通过常规方式初始化会触发系统无法实例化的异常。

具体修复步骤 #

1. 先确认ViewModel构造结构 #

检查你的DishesViewModel代码，典型的带参构造示例如下：

class DishesViewModel(private val dishRepository: DishRepository) : ViewModel() {
    // API调用相关逻辑
}

这种带参构造无法被系统自动实例化，必须通过自定义工厂类处理。

2. 编写ViewModel工厂类 #

实现ViewModelProvider.Factory接口，负责创建带参数的ViewModel实例：

class DishesViewModelFactory(private val repository: DishRepository) : ViewModelProvider.Factory {
    override fun <T : ViewModel> create(modelClass: Class<T>): T {
        if (modelClass.isAssignableFrom(DishesViewModel::class.java)) {
            @Suppress("UNCHECKED_CAST")
            return DishesViewModel(repository) as T
        }
        throw IllegalArgumentException("无法识别的ViewModel类")
    }
}

3. 在Composable中正确初始化ViewModel #

禁止直接通过DishesViewModel()实例化，必须使用Compose的viewModel()函数传入自定义工厂：

@Composable
fun DishScreen() {
    // 这里假设你已经获取到DishRepository实例（可通过依赖注入或直接初始化）
    val dishRepository = DishRepository()
    val viewModel: DishesViewModel = viewModel(
        factory = DishesViewModelFactory(dishRepository)
    )
    // 后续界面逻辑
}

4. （可选）用Hilt简化注入流程 #

如果项目已集成Hilt，可以通过注解自动处理参数注入，无需手动编写工厂类：

• 给ViewModel构造添加@Inject注解：

class DishesViewModel @Inject constructor(private val dishRepository: DishRepository) : ViewModel() {
    // ...
}

• 在Composable中使用hiltViewModel()获取实例：

@Composable
fun DishScreen() {
    val viewModel: DishesViewModel = hiltViewModel()
    // ...
}

同时确保你的Application类添加了@HiltAndroidApp注解，且Hilt相关依赖（hilt-android、hilt-compose）版本匹配并正确配置。

常见排查点 #

• 检查是否存在直接DishesViewModel()实例化的代码，这是错误的初始化方式，必须通过ViewModelProvider或Compose提供的函数创建。
• 若使用Hilt，确认gradle中已启用Hilt插件，且依赖配置无版本冲突。

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