Android中Room数据库预填充数据的实现方法咨询

嗨，我看你已经搞定了Room的基本配置和schema生成，接下来要做预填充数据库其实分两种常见实用方式，我给你详细拆解说明：

方式一：用生成的Schema手动创建预填充数据库文件（适合数据量较大、需要提前编辑好数据的场景） #

步骤1：基于Schema生成数据库结构

你已经通过room.schemaLocation得到了JSON格式的schema文件，里面包含了完整的表创建语句：

• 找到projectDir/schemas下对应版本的JSON文件，提取出createSql字段里的建表SQL语句；
• 打开一个SQLite可视化工具（比如DB Browser for SQLite、SQLiteStudio），新建空白数据库，执行刚才的建表语句；
• 在工具里手动插入你需要的预填充数据，完成后把数据库文件保存为location_database.db。

步骤2：将数据库文件放入项目资源

在你的Android项目main目录下创建assets文件夹（如果没有的话），可以再建一个databases子文件夹，把刚才保存的location_database.db放进去，最终路径为assets/databases/location_database.db。

步骤3：修改Room数据库初始化代码

在原来的databaseBuilder链上添加createFromAsset方法，指定assets里的数据库路径，修改后的代码如下：

@Database(entities = [Location::class], version = 1, exportSchema = true)
abstract class LocationDatabase : RoomDatabase() {
    abstract fun locationDAO(): LocationDAO
    companion object {
        @Volatile
        private var INSTANCE: LocationDatabase? = null
        fun getDatabase(context: Context): LocationDatabase {
            return INSTANCE ?: synchronized(this) {
                val instance = Room.databaseBuilder(
                    context.applicationContext,
                    LocationDatabase::class.java,
                    "location_database"
                )
                    .createFromAsset("databases/location_database.db") // 新增加载预填充数据库的代码
                    .fallbackToDestructiveMigration() // 注意：后续版本升级建议替换为Migration，避免丢失数据
                    .build()
                INSTANCE = instance
                instance
            }
        }
    }
}

方式二：用Room的Callback自动插入数据（适合数据量小、代码里就能生成的初始数据） #

如果你的预填充数据不多，或者可以通过代码动态生成，不用手动创建数据库文件，直接用Room的回调函数在数据库首次创建时插入数据：

@Database(entities = [Location::class], version = 1, exportSchema = true)
abstract class LocationDatabase : RoomDatabase() {
    abstract fun locationDAO(): LocationDAO
    companion object {
        @Volatile
        private var INSTANCE: LocationDatabase? = null
        fun getDatabase(context: Context): LocationDatabase {
            return INSTANCE ?: synchronized(this) {
                val instance = Room.databaseBuilder(
                    context.applicationContext,
                    LocationDatabase::class.java,
                    "location_database"
                )
                    .addCallback(object : RoomDatabase.Callback() {
                        // 数据库首次创建时触发
                        override fun onCreate(db: SupportSQLiteDatabase) {
                            super.onCreate(db)
                            // 用协程在IO线程执行插入操作，避免阻塞主线程
                            CoroutineScope(Dispatchers.IO).launch {
                                val dao = getDatabase(context).locationDAO()
                                // 插入你的预填充数据，比如一个Location列表
                                dao.insertAll(
                                    Location(lat = 39.9042, lng = 116.4074),
                                    Location(lat = 31.2304, lng = 121.4737)
                                )
                            }
                        }
                    })
                    .fallbackToDestructiveMigration()
                    .build()
                INSTANCE = instance
                instance
            }
        }
    }
}

几个关键注意点 #

• 不管用哪种方式，一定要保证预填充数据库的表结构和你的Room实体类完全匹配，包括列名、数据类型、约束条件，不然Room会抛出异常；
• 如果后续需要升级数据库版本，别再用fallbackToDestructiveMigration()，它会删除现有数据库重新创建，你的预填充数据就没了。应该编写Migration类来处理表结构的变更；
• 用createFromAsset的时候，assets里的数据库版本号要和@Database(version = x)一致，不然需要配合Migration处理版本升级。

备注：内容来源于stack exchange，提问作者ubndra