Flutter应用SQLite初始化后自动插入元数据的问题咨询

问题根源分析 #

你遇到的无限循环问题，核心原因在于**onCreate回调的执行时机与数据库状态冲突**：

• onCreate是数据库首次创建时触发的回调，此时数据库正处于表初始化的过程中。如果在这个阶段调用getSetting("metaDataLoaded")，而该方法内部需要查询settings表（或触发其他数据库操作），会导致数据库初始化逻辑被重复调用——因为此时数据库还未完成所有表的创建，查询操作可能触发重新初始化，进而无限循环调用initDb和onCreate。
• 另一种可能是表的创建顺序错误：你在onCreate中先调用了插入逻辑，而插入逻辑依赖的settings表还未创建，导致查询失败，进而触发异常或循环。

正确实现方案 #

根据你的需求（数据库创建后自动插入元数据，仅执行一次），提供两种可靠的实现方式：

方案一：利用onCreate的天然特性（推荐） #

onCreate本身只会在数据库首次创建时执行一次，完全符合你“仅执行一次”的需求。只需调整onCreate的执行顺序：先创建所有需要的表，再直接插入元数据并标记完成，无需提前查询判断。

Future<Database> initDb() async {
  final dbPath = await getDatabasesPath();
  final path = join(dbPath, 'app_database.db');

  return openDatabase(
    path,
    version: 1,
    onCreate: (db, version) async {
      // 第一步：先创建所有需要的表（包括settings表和元数据表）
      await db.execute('''
        CREATE TABLE settings(
          key TEXT PRIMARY KEY,
          value TEXT NOT NULL
        )
      ''');
      await db.execute('''
        CREATE TABLE meta_data(
          id INTEGER PRIMARY KEY AUTOINCREMENT,
          name TEXT NOT NULL,
          content TEXT NOT NULL
        )
      ''');

      // 第二步：从JSON文件读取并插入元数据
      final metaJson = await rootBundle.loadString('assets/meta_data.json');
      final metaList = jsonDecode(metaJson) as List<dynamic>;
      for (var meta in metaList) {
        await db.insert('meta_data', {
          'name': meta['name'],
          'content': meta['content'],
        });
      }

      // 第三步：标记元数据已加载
      await db.insert('settings', {'key': 'metaDataLoaded', 'value': 'true'});
    },
  );
}

方案二：用SharedPreferences做全局标记（适用于应用首次启动执行） #

如果你的需求是应用首次启动时执行一次（而非仅数据库首次创建），可以用SharedPreferences作为标记——它的操作不依赖SQLite，不会触发数据库循环初始化。

Future<Database> initDb() async {
  final dbPath = await getDatabasesPath();
  final path = join(dbPath, 'app_database.db');
  final prefs = await SharedPreferences.getInstance();

  return openDatabase(
    path,
    version: 1,
    onCreate: (db, version) async {
      // 创建所有表
      await db.execute('''
        CREATE TABLE settings(
          key TEXT PRIMARY KEY,
          value TEXT NOT NULL
        )
      ''');
      await db.execute('''
        CREATE TABLE meta_data(
          id INTEGER PRIMARY KEY AUTOINCREMENT,
          name TEXT NOT NULL,
          content TEXT NOT NULL
        )
      ''');
    },
    onOpen: (db) async {
      // 检查SharedPreferences中的标记
      final isMetaLoaded = prefs.getBool('metaDataLoaded') ?? false;
      if (!isMetaLoaded) {
        // 插入元数据
        final metaJson = await rootBundle.loadString('assets/meta_data.json');
        final metaList = jsonDecode(metaJson) as List<dynamic>;
        for (var meta in metaList) {
          await db.insert('meta_data', {
            'name': meta['name'],
            'content': meta['content'],
          });
        }

        // 更新标记
        await prefs.setBool('metaDataLoaded', true);
        await db.insert('settings', {'key': 'metaDataLoaded', 'value': 'true'});
      }
    },
  );
}

关键注意事项 #

• 永远不要在onCreate回调中执行依赖数据库查询的操作（比如getSetting），此时数据库还未完成初始化，极易触发循环或异常。
• 如果必须做状态判断，优先使用不依赖数据库的存储（如SharedPreferences），或确保判断逻辑在所有表创建完成后执行。

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