如何将Flutter SQLite迁移至Kotlin Room并保留用户数据？

方案完全可行，且能实现零数据丢失 #

Room 是 Android 对 SQLite 的官方封装，底层完全基于 SQLite 数据库文件，只要确保 Room 的配置与原 Flutter 端的 SQLite 结构完全匹配，就能无缝读取原有数据，核心步骤如下：

• 1. 复刻原表结构至 Room Entity
  从原 Flutter 代码的建表语句（或提取用户数据库文件分析结构）中，获取所有表的表名、列名、数据类型、主键约束、索引、非空规则等信息，在 Kotlin 中编写对应的 Room Entity：

  @Entity(tableName = "原表名") // 必须指定原表名，避免Room默认用类名
  data class User(
      @PrimaryKey(autoGenerate = false) // 原表主键是否自增需完全匹配
      val id: Int,
      val username: String, // 列名、类型与原表完全一致
      val create_time: Long // 下划线命名需和原表保持一致，显式指定更安全
  )
  

• 2. 匹配数据库版本与文件名

  • 确认原 Flutter SQLite 数据库的版本号（若未显式设置，默认值为 1），在 Room 的 @Database 注解中设置相同的 version 值；
  • 确保 Room 使用的数据库文件名与原 Flutter 端完全相同，示例配置：

    @Database(entities = [User::class], version = 1, name = "app_data.db")
    abstract class AppDatabase : RoomDatabase() {
        abstract fun userDao(): UserDao
    }
    

• 3. 适配数据库存储路径
  Flutter 的 sqflite 插件默认将数据库文件存储在 /data/data/<你的包名>/databases/ 目录下，Room 默认路径与该目录一致，只要包名和签名与原应用保持一致，新应用就能直接访问到原有数据库文件。

• 4. 测试验证迁移逻辑
  用测试设备安装原 Flutter 应用并生成测试数据，再安装新的 Kotlin 应用（确保签名、包名一致），检查 Room 是否能正常读取所有原有数据，确认无丢失后再全量发布。

若迁移方案未适配成功，用户更新后的数据风险 #

如果 Room 配置与原 SQLite 结构不匹配（如表名/列名不一致、版本号冲突），默认情况下 Room 会抛出异常，且不会自动兼容原数据库：

• 若未在 Room Database 构建器中设置 fallbackToDestructiveMigration()，应用会崩溃；
• 若设置了该方法，Room 会删除原有数据库并重建新库，导致所有用户数据丢失。

如果想避免这种极端情况，可以在新应用中添加兼容逻辑：先尝试用 Room 打开数据库，若失败则直接通过原生 SQLite API 读取原数据库文件，保证用户数据不丢失，但这种方式需要额外编写兼容代码，建议优先做好前面的迁移适配工作。

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