Flutter中如何实现SQLite新增字段并升级数据库

在Flutter项目中已经使用了SQLite数据库，现在需要给现有表新增字段。请问应该如何正确实现数据库升级？目前遇到的问题是直接修改表结构会导致旧版本用户的数据丢失。希望了解具体的步骤：1. 如何编写升级逻辑；2. 如何处理新旧版本数据迁移；3. 是否需要维护数据库版本号。求一个完整的实现方案或示例代码。

2 回复

在Flutter中，使用sqflite库升级数据库并新增字段：

  1. 在onUpgrade方法中增加数据库版本号。
  2. 执行ALTER TABLE语句添加新字段：
ALTER TABLE table_name ADD COLUMN new_column TEXT;
  1. 在openDatabase时传入新版本号触发升级。

更多关于Flutter中如何实现SQLite新增字段并升级数据库的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在 Flutter 中实现 SQLite 新增字段并升级数据库，主要通过 onUpgrade 方法处理数据库版本升级。以下是步骤和示例代码：

实现步骤

  1. 定义数据库版本号：增加版本号以触发升级。
  2. 修改 onCreate 和 onUpgrade：在创建和升级时处理表结构变更。
  3. 执行 ALTER TABLE：在 onUpgrade 中使用 SQL 语句添加新字段。

示例代码

  1. 数据库帮助类：
import 'package:sqflite/sqflite.dart';

class DatabaseHelper {
  static Database? _database;
  static const String dbName = 'my_database.db';
  static const int dbVersion = 2; // 版本号从 1 增加到 2

  // 初始化数据库
  Future<Database> get database async {
    _database ??= await _initDatabase();
    return _database!;
  }

  _initDatabase() async {
    return openDatabase(
      join(await getDatabasesPath(), dbName),
      onCreate: _onCreate,
      version: dbVersion,
      onUpgrade: _onUpgrade,
    );
  }

  // 创建表（初始版本）
  Future<void> _onCreate(Database db, int version) async {
    await db.execute('''
      CREATE TABLE my_table (
        id INTEGER PRIMARY KEY,
        name TEXT NOT NULL
      )
    ''');
  }

  // 升级数据库（新增字段）
  Future<void> _onUpgrade(Database db, int oldVersion, int newVersion) async {
    if (oldVersion < 2) {
      await db.execute('ALTER TABLE my_table ADD COLUMN email TEXT');
    }
    // 可添加更多版本判断，例如 if (oldVersion < 3) { ... }
  }
}
  1. 使用示例：
final db = await DatabaseHelper().database;
// 插入数据（包含新字段）
await db.insert('my_table', {
  'name': 'Alice',
  'email': 'alice@example.com', // 新增字段
});

注意事项

  • 版本号管理：每次修改表结构时递增 dbVersion。
  • 数据迁移：复杂变更（如重命名字段）需备份数据并重建表。
  • 测试：确保旧版本数据能正确升级。

通过以上方法，即可安全地新增字段并升级数据库。

回到顶部