如何在包含多张表的Room数据库中实现数据预填充？

核心实现步骤 #

1. 定义对应数据表的实体类 #

每个独立数据表必须绑定一个添加@Entity注解的实体类，不同实体的tableName不能重复，主键必须通过@PrimaryKey明确标注，漏加注解的实体不会被Room识别为数据表。

// 用户表实体
@Entity(tableName = "user_table")
data class User(
    @PrimaryKey(autoGenerate = true) val id: Int = 0,
    val name: String,
    val age: Int
)

// 商品表实体
@Entity(tableName = "goods_table")
data class Goods(
    @PrimaryKey(autoGenerate = true) val id: Int = 0,
    val goodsName: String,
    val price: Double
)

2. 配置Room数据库核心类 #

自定义类继承RoomDatabase，注意以下几个必填配置，漏配大概率触发找不到表、数据库不可用错误：

• @Database注解的entities参数必须列出所有表对应的实体类，少加任何一个实体就会报对应表不存在
• version参数为数据库版本号，需要和预填充逻辑、迁移逻辑保持一致
• 每个表对应的Dao接口，必须在数据库类中定义抽象获取方法
• 数据库实例采用单例模式实现，禁止每次操作都新建实例，否则容易触发数据库锁、实例被回收导致不可用的问题
• 预填充逻辑写在数据库onCreate回调中，强制在IO线程执行，禁止主线程直接操作数据库

参考实现代码：

@Database(
    entities = [User::class, Goods::class],
    version = 1,
    exportSchema = false
)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
    abstract fun goodsDao(): GoodsDao

    companion object {
        @Volatile
        private var INSTANCE: AppDatabase? = null
        fun getInstance(context: Context): AppDatabase {
            return INSTANCE ?: synchronized(this) {
                val instance = Room.databaseBuilder(
                    context.applicationContext,
                    AppDatabase::class.java,
                    "app_main.db"
                )
                .addCallback(object : Callback() {
                    override fun onCreate(db: SupportSQLiteDatabase) {
                        super.onCreate(db)
                        INSTANCE?.let { dbInstance ->
                            CoroutineScope(Dispatchers.IO).launch {
                                // 预填充用户表初始数据
                                dbInstance.userDao().insertAll(
                                    User(name = "张三", age = 22),
                                    User(name = "李四", age = 25)
                                )
                                // 预填充商品表初始数据
                                dbInstance.goodsDao().insertAll(
                                    Goods(goodsName = "矿泉水", price = 2.0),
                                    Goods(goodsName = "全麦面包", price = 5.5)
                                )
                            }
                        }
                    }
                })
                .build()
                INSTANCE = instance
                instance
            }
        }
    }
}

如果采用assets目录下预置SQLite文件的方式做预填充，必须保证预置文件内的表名、字段结构、字段类型和当前版本定义的实体类完全一致，否则启动直接报错。

3. 定义各表对应的Dao接口 #

每个表对应一个添加@Dao注解的接口，SQL查询语句内的表名必须和实体类定义的tableName完全一致，Room对表名大小写敏感。

// 用户表访问接口
@Dao
interface UserDao {
    @Insert
    suspend fun insertAll(vararg users: User)

    @Query("SELECT * FROM user_table")
    fun observeAllUsers(): Flow<List<User>>
}

// 商品表访问接口
@Dao
interface GoodsDao {
    @Insert
    suspend fun insertAll(vararg goods: Goods)

    @Query("SELECT * FROM goods_table")
    fun observeAllGoods(): Flow<List<Goods>>
}

4. UI层数据读取逻辑 #

所有数据库读写操作必须在非主线程执行，通过ViewModel持有数据观察对象，不要在Activity/Fragment中直接操作数据库实例：

class MainViewModel(application: Application) : AndroidViewModel(application) {
    private val dbInstance = AppDatabase.getInstance(application)
    // 分别从两个表取数据，转成LiveData供UI层观察
    val userList: LiveData<List<User>> = dbInstance.userDao().observeAllUsers().asLiveData()
    val goodsList: LiveData<List<Goods>> = dbInstance.goodsDao().observeAllGoods().asLiveData()
}

Activity/Fragment中直接观察对应LiveData，数据变化时自动更新UI即可，不需要手动切换线程。

常见报错排查项 #

• 提示「找不到对应表」：优先检查@Database注解的entities数组是否漏加对应实体，再检查SQL语句内的表名和实体定义的tableName是否完全匹配。
• 提示「数据库不可用/数据库已关闭」：检查是否每次操作都新建数据库实例，是否在操作未完成时手动调用了close()方法，是否存在跨进程违规操作数据库的逻辑。
• 预填充数据不生效：onCreate回调仅在数据库首次创建时触发，已安装过App的设备需要卸载重装，或升级数据库版本在迁移逻辑中补充初始化数据；同时检查预填充逻辑是否在IO线程执行，是否被主线程阻塞。
• 预填充外部DB文件时崩溃：检查预置DB文件的表结构、字段和当前版本实体类是否完全匹配，结构不一致时必须写迁移逻辑，不要直接调用fallbackToDestructiveMigration()暴力删库，会导致预填充数据丢失。

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