如何将.sqlite文件转换为.db文件用于Android Room预填充数据库？

一、先澄清：SQLite文件与.db文件的关系 #

其实.sqlite和.db只是文件扩展名的差异，本质都是SQLite数据库格式的文件。直接重命名扩展名（比如data.sqlite改为data.db）就能被Room识别，这是最简单的转换方式。

如果重命名后Room仍无法识别，大概率是数据库结构与Room实体类不匹配，而非文件格式问题。

二、两种可行的处理方式 #

1. 手动快速转换（推荐）

• 直接重命名：将你的.sqlite文件扩展名改为.db，放入assets文件夹即可。
• 结构验证：用SQLiteStudio、DB Browser for SQLite等工具打开文件，检查表结构（列名、数据类型、主键、约束）是否与你的Room实体类注解完全匹配。比如实体类用@ColumnInfo(name = "user_id")指定的列名，必须和数据库中的列名一致。

2. 程序化实现（无需手动改扩展名）

Room的createFromAsset方法支持直接加载.sqlite格式的文件，不需要转换。只需在数据库构建时指定正确的资产路径：

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

    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_database.db" // Room最终生成的数据库文件名
                )
                .createFromAsset("preloaded_data.sqlite") // 直接引用assets中的sqlite文件
                .build()
                INSTANCE = instance
                instance
            }
        }
    }
}

三、只读预填充数据库的关键配置 #

因为你的项目是只读操作，可以额外做以下优化：

• 禁止主线程查询（正式项目推荐）：使用协程、LiveData或RxJava执行DAO操作，避免allowMainThreadQueries()带来的ANR风险。
• 强制只读模式：通过自定义SupportSQLiteOpenHelper.Factory打开数据库时设置只读权限，防止误写：

val factory = object : SupportSQLiteOpenHelper.Factory {
    override fun create(config: SupportSQLiteOpenHelper.Configuration): SupportSQLiteOpenHelper {
        return object : FrameworkSQLiteOpenHelper(config.context, config.name, config.callback) {
            override fun getWritableDatabase(): SQLiteDatabase {
                // 只读场景下返回只读数据库
                return getReadableDatabase()
            }
        }
    }
}

// 在数据库构建时添加
Room.databaseBuilder(...)
    .openHelperFactory(factory)
    .build()

四、常见问题排查 #

• 结构不匹配报错：开启exportSchema = true，在app/schemas目录下生成Room的schema文件，对比预填充数据库的表结构，修正实体类注解或调整数据库表。
• 资产文件找不到：确认文件放在src/main/assets目录下，路径拼写正确（区分大小写），如果放在子目录，路径写subfolder/preloaded_data.sqlite。
• 版本冲突：Room的version值需与你定义的schema版本一致，预填充数据库的schema要与Room生成的schema完全兼容。

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