floor flutter数据库迁移如何实现

最近在Flutter项目中使用Floor数据库，现在需要做数据迁移。请问如何正确实现Floor数据库的版本升级和迁移？具体步骤是什么？需要修改哪些文件？如果现有数据表结构发生变化，怎样才能确保旧数据不丢失？有没有最佳实践或常见问题的解决方案？

2 回复

Flutter中可使用sqflite库实现数据库迁移。在onUpgrade方法中，根据新旧版本号执行SQL语句（如ALTER TABLE）。建议使用moor或floor等ORM库简化操作。

更多关于floor flutter数据库迁移如何实现的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在 Flutter 中实现数据库迁移（如使用 sqflite 库），主要涉及在数据库版本升级时修改表结构或数据。以下是步骤和示例代码：

1. 设置数据库版本

在打开数据库时指定版本号，当版本增加时触发迁移。

final database = await openDatabase(
  path,
  version: 2, // 更新版本号以触发迁移
  onCreate: _onCreate,
  onUpgrade: _onUpgrade, // 定义迁移逻辑
);

2. 实现迁移逻辑

在 onUpgrade 中处理版本变更，例如添加新列：

Future<void> _onUpgrade(Database db, int oldVersion, int newVersion) async {
  if (oldVersion < 2) {
    await db.execute('ALTER TABLE your_table ADD COLUMN new_column TEXT');
  }
  if (oldVersion < 3) {
    // 处理更多版本变更
  }
}

3. 完整示例

import 'package:sqflite/sqflite.dart';

class DBHelper {
  static Future<Database> initDB() async {
    return openDatabase(
      await getDatabasesPath() + '/app.db',
      version: 2,
      onCreate: (db, version) {
        return db.execute(
          'CREATE TABLE items(id INTEGER PRIMARY KEY, name TEXT)',
        );
      },
      onUpgrade: (db, oldVersion, newVersion) async {
        if (oldVersion < 2) {
          await db.execute('ALTER TABLE items ADD COLUMN description TEXT');
        }
      },
    );
  }
}

关键点：

  • 版本号：每次 schema 变更需递增版本。
  • 渐进迁移：通过 oldVersion 判断逐步执行变更（例如从 v1 到 v3）。
  • 测试：务必在开发阶段验证迁移逻辑，避免数据丢失。

如果需要复杂迁移（如数据转换），可结合 Batch 操作或临时表实现。

回到顶部