Flutter项目添加sqflite或其依赖包时出现报错问题

1. 检查pubspec.yaml依赖配置 #

确保sqflite的依赖格式正确，避免版本冲突或语法错误：

dependencies:
  flutter:
    sdk: flutter
  sqflite: ^2.3.2 # 使用官方标注的最新稳定版，避免带dev/pre后缀的预发布版本

配置完成后执行flutter pub get，留意终端输出的报错信息，若提示版本冲突，可尝试指定与当前Flutter版本兼容的sqflite版本号，或执行flutter pub upgrade更新所有依赖。

2. 清理项目缓存与构建文件 #

• 执行flutter clean清除旧的构建缓存
• 重新运行flutter pub get拉取依赖
• iOS平台：进入项目根目录下的ios文件夹，执行pod deintegrate移除旧Pod依赖，再执行pod install重新安装
• Android平台：删除android/.gradle目录，然后重新构建项目

3. 排查代码中的错误调用 #

报错可能源于代码使用方式不当，而非依赖本身问题：

• 数据库初始化必须在异步函数中执行，示例：

Future<Database> initDB() async {
  final dbPath = await getDatabasesPath();
  return openDatabase(
    join(dbPath, 'app_db.db'),
    onCreate: (db, version) {
      return db.execute('CREATE TABLE items(id INTEGER PRIMARY KEY, name TEXT)');
    },
    version: 1,
  );
}

• 禁止在initState等同步生命周期函数中直接调用数据库操作，需用FutureBuilder或async/await处理异步逻辑

4. 验证平台兼容性与环境 #

• 执行flutter doctor确认Flutter环境无异常，无缺失依赖
• Android平台：确保android/app/build.gradle中minSdkVersion不低于21
• iOS平台：确保项目部署目标版本不低于11.0

5. 最小Demo测试排查冲突 #

新建空Flutter项目，仅添加sqflite依赖和最基础的数据库初始化代码，运行测试。若Demo正常运行，说明原项目存在其他依赖或代码冲突，需逐步移除其他第三方包排查问题。

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