Moor框架下插入Task时触发SqliteException(1)：找不到main.checkLists表问题求助

看起来你遇到的问题有点绕——明明是向Tasks表插入数据，却报错找不到checkLists表，这大概率是外键约束触发的关联表检查导致的，我来帮你一步步排查和解决：

核心原因分析 #

你的Tasks表应该通过checkListId字段和CheckLists表建立了外键关联，当你向Tasks插入数据时，SQLite会自动做两个检查：

1. 你插入的checkListId对应的记录是否存在于CheckLists表中
2. CheckLists表本身是否存在于当前数据库里

报错信息指向main.checkLists不存在，说明第二个检查失败了——当前数据库里根本没有CheckLists表，而这个问题在执行插入操作时才被触发暴露出来。

逐步排查与修复 #

1. 确认数据库版本号是否正确更新 #

首先检查你的AppDatabase初始化代码，确保版本号和迁移逻辑匹配：

// 示例：初始化数据库时指定正确的版本号
LazyDatabase _openConnection() {
  return LazyDatabase(() async {
    final dbFolder = await getApplicationDocumentsDirectory();
    final file = File(p.join(dbFolder.path, 'app.db'));
    // 新增Tasks表后，版本号要从原来的1改成2（如果之前版本是1的话）
    return VmDatabase(file, migrationStrategy: migration, version: 2);
  });
}

如果你的数据库版本号没有从旧版本升级，onUpgrade方法根本不会触发，老用户的数据库里只会有原来的表（甚至可能缺少CheckLists表），自然会报错。

2. 补全迁移逻辑中CheckLists表的创建 #

你的onUpgrade只处理了创建Tasks表，但如果之前的版本（比如version 1）中没有正确创建CheckLists表，或者部分用户的数据库缺少这个表，就需要在迁移中补上：

MigrationStrategy get migration => MigrationStrategy(
      onCreate: (m) async {
        await m.createAll(); // 创建所有表
        final TasksCompanion task = TasksCompanion.insert(checkListId: 1, toDo:'First');
        await into(tasks).insert(task);
      },
      onUpgrade: (migrator, from, to) async {
        if(from == 1){
          // 先确保CheckLists表存在，再创建Tasks表
          await migrator.createTable(checkLists);
          await migrator.createTable(tasks);
        }
      },
      beforeOpen: (details) async {
        await customStatement('PRAGMA foreign_keys = ON');
        // 调试：打印现有表，确认CheckLists是否存在
        final tables = await customStatement("SELECT name FROM sqlite_master WHERE type='table'");
        print('当前数据库表：$tables');
      },
    );

添加这个调试打印可以帮你快速确认当前数据库里到底有哪些表，定位问题根源。

3. 检查Tasks表的外键定义是否正确 #

确认你的Tasks表定义中，外键关联的是正确的CheckLists表和主键字段：

class Tasks extends Table {
  IntColumn get id => integer().autoIncrement()();
  // 确保这里的references指向正确的CheckLists表和主键字段
  IntColumn get checkListId => integer().references(CheckLists, #id)();
  TextColumn get toDo => text()();
  DateTimeColumn get createdAt => dateTime().nullable()();
}

如果外键关联的表名或字段名写错，也可能触发类似的表不存在错误。

4. 临时调试方案（仅测试阶段） #

如果是开发测试阶段，可以先删除应用重新安装，或者清理应用的数据库缓存，让数据库从onCreate重新执行，确认CheckLists和Tasks表都能被正确创建。但这个方法只适合测试，正式环境必须依赖迁移逻辑保证数据兼容。

总结 #

最可能的问题是数据库版本号未更新导致迁移逻辑未执行，或者迁移逻辑中没有确保CheckLists表存在。按照上面的步骤排查，应该能快速解决这个问题。

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