Flutter sqflite数据库助手适配Web及插入默认值报错解决

排查方向及解决方案 #

1. 验证Web端表结构是否正确创建

Web端的sqflite_common_ffi_web可能因初始化流程或缓存问题，导致表结构与移动端不一致。执行以下代码检查FragranceNotes表的列信息：

// 在数据库初始化后执行
final columns = await db.rawQuery('PRAGMA table_info(FragranceNotes);');
print(columns);

查看输出结果中是否包含Woody列（注意大小写，部分Web环境对SQL标识符大小写更敏感）。如果不存在，说明表创建SQL在Web端未正确执行，需确保表创建语句在所有平台完全一致，例如：

CREATE TABLE IF NOT EXISTS FragranceNotes (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  Woody TEXT NOT NULL,
  -- 其他列定义
);

2. 统一列名大小写并使用反引号包裹

SQLite默认对标识符大小写不敏感，但sqflite_common_ffi_web的底层实现可能存在差异。修改插入语句，用反引号包裹列名，避免大小写匹配问题：

// 原插入代码
await db.insert('FragranceNotes', {'Woody': '暖调木质', ...});

// 修改后（确保列名匹配）
await db.rawInsert(
  'INSERT INTO FragranceNotes (`Woody`, `OtherColumn`) VALUES (?, ?)',
  ['暖调木质', '其他值']
);

3. 确保插入操作在表创建完成后执行

Web端数据库初始化的异步流程可能与原生sqflite不同，需等待表创建完成后再执行默认数据插入。调整代码顺序：

// 初始化数据库
final db = await openDatabase(...);

// 先执行表创建
await db.execute('CREATE TABLE IF NOT EXISTS FragranceNotes (...)');
await db.execute('CREATE TABLE IF NOT EXISTS Tags (...)');

// 再插入默认数据
await _insertDefaultFragranceNotes(db);
await _insertDefaultTags(db);

避免在数据库未完全初始化时触发插入操作。

4. 清除Web端缓存并更新依赖

• 清除浏览器缓存或使用隐私模式测试，排除旧数据库文件的干扰。
• 更新sqflite_common_ffi_web到最新版本，修复已知的兼容性bug：

  flutter pub upgrade sqflite_common_ffi_web
  

5. 检查参数绑定方式

如果使用命名参数插入，确认Web端支持该语法。若存在兼容性问题，切换为位置参数绑定：

// 命名参数写法（可能在Web端有兼容问题）
await db.rawInsert(
  'INSERT INTO FragranceNotes (Woody) VALUES (@Woody)',
  {'@Woody': '木质调'}
);

// 切换为位置参数
await db.rawInsert(
  'INSERT INTO FragranceNotes (Woody) VALUES (?)',
  ['木质调']
);

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