使用预填充Room数据库时应用崩溃，报NullPointerException

核心排查方向 #

• 实体非空约束与数据库数据不匹配
  Room实体中标记为@NonNull（或Kotlin默认非空的String/基本类型）的字段，若预填充数据库对应列存在NULL值，查询时cursor.getString()会返回null，触发NPE。

  • 解决：要么修改预填充数据库，将NULL值替换为合理默认值（比如空字符串）；要么将实体中对应字段改为可空类型（如String?）。

• 列名/表名映射不一致
  检查Room实体的@ColumnInfo(name = "...")指定的列名，是否与预填充数据库的列名完全一致（包括大小写、拼写）；同时确认@Entity(tableName = "...")的表名与数据库表名匹配。

  • 辅助排查：查看KAPT生成的DAO实现类（路径：build/generated/source/kapt/debug/[你的包名]/[DAO名]Impl.java），找到getAllCocktails()对应的查询代码，核对列索引对应的字段是否正确。

• 数据库字段类型不匹配
  用SQLite工具打开预填充的test.db，对比每个字段的类型（比如TEXT/INTEGER）是否与Room实体字段类型完全匹配。例如实体中是String类型，但数据库列是INTEGER且存了NULL，也会导致转换时的异常。

可行解决方案 #

1. 添加类型转换器处理NULL值
   如果需要保留数据库中的NULL值，可给对应字段添加类型转换器，将NULL转为默认值：

   class StringConverter {
       @TypeConverter
       fun nullSafeString(value: String?): String {
           return value ?: ""
       }
   }
   

   然后在RoomDatabase注解中启用转换器：

   @Database(entities = [Cocktail::class], version = 1)
   @TypeConverters(StringConverter::class)
   abstract class AppDatabase : RoomDatabase() {
       // DAO定义
   }
   

2. 逐步定位问题字段
   编写多个局部查询方法，逐个查询字段：

   @Query("SELECT id FROM cocktails")
   fun getIds(): List<Int>
   
   @Query("SELECT name FROM cocktails")
   fun getNames(): List<String>
   

   依次调用这些方法，找到触发崩溃的具体字段，再针对性处理。

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