Hilt无法创建NewScreenViewModel实例问题求助

核心问题本质 #

报错Cannot create an instance of class ...NewScreenViewModel且提示无无参构造，说明Hilt的ViewModel注入逻辑根本没生效——系统找不到Hilt生成的ViewModel工厂，只能退而求其次尝试用默认无参构造创建，自然失败。

逐一排查验证 #

1. 盯死ViewModel的注解和构造函数 #

必须同时满足两个条件：

• 类上标注@HiltViewModel
• 唯一构造函数用@Inject标注（不能加无参构造）
  示例代码：

@HiltViewModel
class NewScreenViewModel @Inject constructor(
    private val yourRepository: YourRepository
) : ViewModel() {
    // 业务逻辑代码
}

别手贱加无参构造，Hilt只认带@Inject的构造函数。

2. 检查ViewModel的获取方式 #

• 宿主Activity必须加@AndroidEntryPoint
• 用正确的方式拿实例：
  • Jetpack Compose场景：用hiltViewModel()，不能自己new或者用普通ViewModelProvider

    @AndroidEntryPoint
    class MainActivity : ComponentActivity() {
        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContent {
                val viewModel: NewScreenViewModel = hiltViewModel()
                // ...
            }
        }
    }
    

  • View系统场景：用ViewModelProvider(this)[NewScreenViewModel::class.java]，不能传自定义Factory（除非是Hilt生成的）

3. 验证Room组件的Hilt注入链路 #

Room的DAO必须能被Hilt正确注入到仓库，仓库再注入到ViewModel：

• 仓库类的构造函数要加@Inject：

  class YourRepository @Inject constructor(
      private val yourDao: YourDao
  ) {
      // DAO调用逻辑
  }
  

• 如果是自定义Room数据库实例，要通过Hilt模块提供：

  @Module
  @InstallIn(SingletonComponent::class)
  object RoomModule {
      @Provides
      fun provideYourDao(database: YourDatabase): YourDao = database.yourDao()
  
      @Provides
      @Singleton
      fun provideYourDatabase(@ApplicationContext context: Context): YourDatabase {
          return Room.databaseBuilder(
              context,
              YourDatabase::class.java,
              "app_database"
          ).build()
      }
  }
  

  这里如果Room初始化失败（比如数据库版本不对、DAO注解错误），会导致整个注入链路断了，Hilt就会放弃注入，触发无参构造的错误。

4. 核对Gradle依赖的完整性 #

别漏了关键依赖，尤其是Compose场景的导航依赖：

• 项目根build.gradle：

  dependencies {
      classpath 'com.google.dagger:hilt-android-gradle-plugin:2.48' // 版本统一即可
  }
  

• 模块build.gradle：

  plugins {
      id 'kotlin-kapt'
      id 'dagger.hilt.android.plugin'
  }
  
  dependencies {
      implementation 'com.google.dagger:hilt-android:2.48'
      kapt 'com.google.dagger:hilt-android-compiler:2.48'
      implementation 'androidx.hilt:hilt-navigation-compose:1.0.0' // Compose必加
  }
  

  版本要统一，别混用不同版本的Hilt依赖。

5. 清理编译缓存 #

有时候编译缓存会搞鬼，导致Hilt的注解处理器没生成正确的工厂类。直接执行File -> Invalidate Caches... -> Invalidate and Restart，重启后重新编译项目。

6. 确认Application类配置 #

必须有一个标注@HiltAndroidApp的Application类，并且在Manifest中指定：

@HiltAndroidApp
class YourApp : Application() {}

Manifest里：

<application
    android:name=".YourApp"
    <!-- 其他配置 -->
>

这是Hilt的入口，没这个的话整个注入系统都不工作。

最后一招：深挖报错堆栈 #

如果以上都没问题，把报错堆栈里的Caused by部分全部贴出来——很多时候真正的错误（比如Room初始化失败、仓库依赖缺失）被隐藏在堆栈深处，Hilt只是抛出了最表层的“无参构造”错误。

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