Android Room：assets中.db文件更新后如何刷新缓存数据库？

核心问题分析 #

Room的createFromAsset仅在目标数据库不存在时才会从assets目录复制文件。当你更新assets里的.db数据但未处理旧数据库时，Room会直接使用已存在的旧库，不会自动替换。之前尝试的fallbackToDestructiveMigration虽然会删除旧库，但可能因Room内部逻辑或操作细节问题，未能触发重新复制assets文件。

可行解决方案 #

要实现"版本更新时强制覆盖旧库，重新加载assets新数据"，可以通过版本号控制+手动删除旧数据库文件的方式实现，具体步骤如下：

1. 定义数据库版本常量 #

修改数据库类，将版本号和库名提取为常量，方便后续版本对比：

@Database(entities = [AEntity::class, BEntity::class], version = 2)
abstract class CustomDatabase : RoomDatabase() {
    abstract fun customDao(): CustomDao

    companion object {
        const val DB_NAME = "custom-database"
        const val CURRENT_VERSION = 2 // 每次更新assets数据时，递增此版本号
    }
}

2. 初始化时检查并删除旧库 #

在数据库初始化前，检查现有数据库的版本，如果低于当前版本，直接删除旧库文件（包括WAL相关的辅助文件），确保Room重新从assets复制新数据：

fun getCustomDatabase(context: Context): CustomDatabase {
    val dbFile = context.getDatabasePath(CustomDatabase.DB_NAME)
    val walFile = context.getDatabasePath("${CustomDatabase.DB_NAME}-wal")
    val shmFile = context.getDatabasePath("${CustomDatabase.DB_NAME}-shm")

    if (dbFile.exists()) {
        try {
            // 读取旧数据库版本
            val oldDb = SQLiteDatabase.openDatabase(dbFile.path, null, SQLiteDatabase.OPEN_READONLY)
            val oldVersion = oldDb.version
            oldDb.close()

            // 版本低于当前时，删除旧库文件
            if (oldVersion < CustomDatabase.CURRENT_VERSION) {
                dbFile.delete()
                walFile.delete()
                shmFile.delete()
            }
        } catch (e: Exception) {
            // 读取版本失败时，直接删除旧库
            dbFile.delete()
            walFile.delete()
            shmFile.delete()
        }
    }

    // 初始化Room数据库
    return Room.databaseBuilder(
        context.applicationContext,
        CustomDatabase::class.java,
        CustomDatabase.DB_NAME
    )
        .createFromAsset("data.db")
        .fallbackToDestructiveMigration() // 兜底处理未覆盖的迁移场景
        .build()
}

3. 更新assets数据时的操作 #

每次修改assets里的data.db内容后，需要：

• 将CustomDatabase的version和CURRENT_VERSION常量递增（比如从2改成3）
• 重新编译安装应用，此时代码会自动删除旧库并复制新的预加载数据

为什么之前的方法无效？ #

fallbackToDestructiveMigration会销毁旧数据库，但Room重建时可能因以下原因未复制assets文件：

• 模拟器缓存未清除，旧数据库文件未被彻底删除
• assets里的新.db文件未正确打包到APK中（可通过Build > Analyze APK验证）
• Room内部逻辑中，破坏性迁移后优先创建空库而非复制assets文件

手动删除旧库文件可以彻底规避这些问题，确保Room每次版本升级时都重新加载最新的预加载数据。

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