如何从脚本或外部数据库向Jetpack Compose Room数据库插入数据？

方案一：用Room官方批量插入API（推荐） #

Room本身支持批量插入，不需要手动写大量INSERT语句，只需要将数据整理成实体类列表，调用Dao的批量插入方法即可，性能和维护性都更好。

1. 定义实体类和Dao

// 励志语句实体类
@Entity(tableName = "quotes")
data class Quote(
    @PrimaryKey(autoGenerate = true) val id: Int = 0,
    val content: String, // 励志语句内容
    val author: String? = null // 可选的作者字段
)

// Dao接口
@Dao
interface QuoteDao {
    // onConflict设置为REPLACE，避免重复插入时报错
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insertAll(quotes: List<Quote>)
}

2. 从本地资源加载数据
   把所有励志语句整理成JSON文件（比如assets/quotes.json），格式如下：

[
    {"content": "不要等待机会，而要创造机会。"},
    {"content": "人生最大的错误是不断担心会犯错。"},
    // ... 剩下98条语句
]

然后编写工具方法读取并解析这个JSON文件：

fun loadQuotesFromAssets(context: Context): List<Quote> {
    val jsonContent = context.assets.open("quotes.json")
        .bufferedReader()
        .use { it.readText() }
    return Gson().fromJson(jsonContent, object : TypeToken<List<Quote>>() {}.type)
}

3. 数据库初始化时执行批量插入
   通过RoomDatabase的Callback，在数据库第一次创建时执行插入操作：

@Database(entities = [Quote::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    abstract fun quoteDao(): QuoteDao

    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,
                    "motivational_quotes_db"
                )
                .addCallback(object : Callback() {
                    override fun onCreate(db: SupportSQLiteDatabase) {
                        super.onCreate(db)
                        // 在IO线程执行插入，避免阻塞主线程
                        CoroutineScope(Dispatchers.IO).launch {
                            val quotes = loadQuotesFromAssets(context)
                            getInstance(context).quoteDao().insertAll(quotes)
                        }
                    }
                })
                .build()
                INSTANCE = instance
                instance
            }
        }
    }
}

方案二：执行SQL脚本文件（适合坚持用INSERT语句的场景） #

如果一定要用包含100条INSERT语句的脚本，可以把脚本放在assets目录，然后在数据库初始化时读取并执行。

1. 编写SQL脚本
   创建assets/quotes.sql，内容示例：

INSERT INTO quotes (content) VALUES ('不要等待机会，而要创造机会。');
INSERT INTO quotes (content) VALUES ('人生最大的错误是不断担心会犯错。');
-- ... 剩下98条INSERT语句

2. 在数据库初始化时执行脚本
   修改RoomDatabase的Callback，读取脚本并逐条执行：

override fun onCreate(db: SupportSQLiteDatabase) {
    super.onCreate(db)
    CoroutineScope(Dispatchers.IO).launch {
        val sqlScript = context.assets.open("quotes.sql")
            .bufferedReader()
            .use { it.readText() }
        // 分割SQL语句，过滤空行和注释
        val statements = sqlScript.split(";")
            .map { it.trim() }
            .filter { it.isNotEmpty() && !it.startsWith("--") }
        
        statements.forEach { statement ->
            db.execSQL(statement)
        }
    }
}

注意事项 #

• onCreate回调只会在数据库第一次创建时执行，不会在版本更新时重复执行，不用担心重复插入数据。
• 所有数据库操作必须放在后台线程（比如用Coroutine的IO调度器），不能在主线程执行。
• 方案一的批量插入API会被Room优化，比方案二的逐条执行SQL语句性能更高，推荐优先使用。

内容的提问来源于stack exchange，提问作者Yunus Emrah Uluçay