Android构建输出仅显示[HILT] Room搭配Hilt使用异常排查

构建阶段只打印[HILT]标识、无其他明文报错，本质是注解处理器执行阶段触发静默中断，按以下顺序排查即可定位问题：

• 开启注解处理器详细日志，拿到被吞掉的真实报错
  在模块级build.gradle的配置块中添加如下参数，重新构建即可输出完整错误栈：

  // 使用KAPT的场景添加这段配置
  kapt {
      verboseExecution = true
      arguments {
          arg("dagger.hilt.shareTestComponents", "false")
          arg("room.incremental", "false")
      }
  }
  
  // 使用KSP的场景将上面的kapt替换为ksp即可
  

  配置完成后执行带栈追踪的构建命令：./gradlew clean assembleDebug --stacktrace，就不会再出现只有[HILT]标识、无报错内容的情况。

• 核对版本兼容性与基础写法

  • Hilt 2.44及以上版本必须搭配Room 2.5.0及以上版本使用，低版本Room的注解处理器和高版本Hilt存在类路径冲突，会直接中断注解扫描流程不抛出明文错误
  • 提供Room数据库、DAO实例的Hilt Module必须用@Module + @InstallIn(SingletonComponent::class)标注，实例提供方法必须加@Provides和@Singleton注解，不能用@Binds注解绑定Room相关实例——@Binds只适用于接口实现类绑定，Room实例必须通过Room.databaseBuilder()生成，用错注解会直接触发静默失败
  • Room的@Database标注的抽象类、DAO接口不要加@Inject注解，这类类型不能直接通过构造函数注入，乱加注解会让Hilt尝试直接实例化抽象类型触发中断。

• 检查容易遗漏的配置项

  • 确认自定义Application类加了@HiltAndroidApp注解，同时AndroidManifest.xml的<application>标签的android:name属性指向了你的自定义Application类，漏配Manifest项会导致Hilt代码生成流程不完整，只打印启动标识不输出具体错误
  • 确认所有需要注入的ViewModel加了@HiltViewModel注解，构造函数上的@Inject注解不要漏，不要手动new ViewModel实例
  • 检查Fragment/Activity上的@AndroidEntryPoint注解有没有加在正确的类上，不要漏加宿主类的注解。

• 清除损坏的构建缓存
  注解处理器的增量编译缓存损坏也会导致这类无提示报错，直接执行以下命令清理缓存后重新构建即可：

  ./gradlew clean
  rm -rf ~/.gradle/caches/build-cache-*
  

踩坑统计：80%的同类问题都是因为给Room实例提供方法错用了@Binds注解、或者漏加Manifest里的Application类配置导致的，优先查这两项能省很多时间。

内容的提问来源于stack exchange，提问作者Tuğçe Aksoy