使用ViewModel结合Room数据库仓库时应用崩溃问题排查

1. 修正ViewModel工厂的依赖传递逻辑 #

• 检查自定义ViewModelProvider.Factory实现，必须保证PlayerRepository实例被正确传入ViewModel，避免空指针或初始化失败：

  class PlayerViewModelFactory(private val repository: PlayerRepository) : ViewModelProvider.Factory {
      override fun <T : ViewModel> create(modelClass: Class<T>): T {
          if (modelClass.isAssignableFrom(PlayerViewModel::class.java)) {
              @Suppress("UNCHECKED_CAST")
              return PlayerViewModel(repository) as T
          }
          throw IllegalArgumentException("Unknown ViewModel class")
      }
  }
  

• 确认GameApplication中正确初始化Repository（依赖Room的Dao实例），确保全局实例可用：

  class GameApplication : Application() {
      val database by lazy { PlayerRoomDatabase.getDatabase(this) }
      val playerRepository by lazy { PlayerRepository(database.playerDao()) }
  }
  

2. 规范Composable中ViewModel的获取方式 #

• 手动工厂方式：必须使用Application级上下文获取Repository，避免上下文生命周期不匹配：

  val context = LocalContext.current
  val viewModel = viewModel<PlayerViewModel>(
      factory = PlayerViewModelFactory(
          (context.applicationContext as GameApplication).playerRepository
      )
  )
  

• 若用Hilt依赖注入：ViewModel需加@HiltViewModel注解，Repository通过@Inject或Module提供，Activity加@AndroidEntryPoint，Composable用hiltViewModel()获取。

3. 验证Room数据库初始化的正确性 #

• 检查Room数据库类的@Database注解，确保实体类、Dao接口声明完整，版本号匹配：

  @Database(entities = [Player::class], version = 1, exportSchema = false)
  abstract class PlayerRoomDatabase : RoomDatabase() {
      abstract fun playerDao(): PlayerDao
      
      companion object {
          @Volatile
          private var INSTANCE: PlayerRoomDatabase? = null
          
          fun getDatabase(context: Context): PlayerRoomDatabase {
              return INSTANCE ?: synchronized(this) {
                  val instance = Room.databaseBuilder(
                      context.applicationContext,
                      PlayerRoomDatabase::class.java,
                      "player_database"
                  ).build()
                  INSTANCE = instance
                  instance
              }
          }
      }
  }
  

• 查看Logcat崩溃栈，若出现Room数据完整性、Dao映射错误，需修正实体类字段与Dao方法的匹配（比如主键、字段名对应）。

4. 修正ViewModel内部逻辑 #

• 确保ViewModel构造函数仅接收PlayerRepository，无其他未初始化依赖；操作Room的代码必须放在协程中执行，避免阻塞主线程：

  class PlayerViewModel(private val repository: PlayerRepository) : ViewModel() {
      fun addPlayer(player: Player) {
          viewModelScope.launch {
              repository.insert(player)
          }
      }
  }
  

关键排查技巧 #

1. 打开Logcat筛选Error级别日志，通过崩溃栈轨迹定位具体异常（比如NullPointerException、IllegalStateException），这是最快定位问题的方式。
2. 确认Room、ViewModel、Compose的版本兼容（比如Room 2.5.0+需对应ViewModel 2.5.0+）。

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