解决sqflite中清空表后插入数据失效的问题

在使用sqflite进行Flutter应用开发时，我们经常会遇到需要清空表数据后再插入新记录的场景。本文介绍一个常见问题的解决方案：当执行删除操作后立即插入数据时，数据看似成功写入但实际上并未持久化保存的问题。

问题现象

开发者尝试在保存用户凭证时先清空CREDS表，然后再插入新的凭证记录。代码逻辑如下：

Future<void> dbSaveCreds({required String username, required String password}) async {
  final db = await DatabaseHelper().initDatabase();
  await db.delete('CREDS');
  final data = {'username': username, 'password': password};
  dev.log(name: 'dbSaveCreds', data.toString());
  await db.insert('CREDS', data);
}

这段代码表面上看没有错误，执行时也没有抛出异常，但当应用重启后，新插入的数据却消失了。而如果移除删除操作，仅执行插入，数据却能正常持久化。

问题原因

这种情况通常发生在异步操作中，当多个数据库操作连续执行时，如果没有使用事务(transaction)来保证原子性，可能会出现操作未完整执行的情况。具体可能的原因包括：

1. 删除和插入操作之间没有事务保证，如果应用在两者之间意外终止，可能导致数据不一致
2. 异步操作可能在某些情况下未能正确完成
3. 数据库连接可能在操作过程中被意外关闭

解决方案

使用数据库事务可以确保多个操作要么全部成功，要么全部失败。修改后的代码如下：

Future<void> dbSaveCreds({required String username, required String password}) async {
  final db = await DatabaseHelper().initDatabase();
  await db.transaction((txn) async {
    await txn.delete('CREDS');
    final data = {'username': username, 'password': password};
    await txn.insert('CREDS', data);
  });
}

关键改进点

1. 使用事务包装：将删除和插入操作放在同一个事务中，确保这两个操作作为一个原子单元执行
2. 使用事务对象：在事务回调中使用提供的txn对象执行操作，而不是直接使用db对象
3. 自动提交：事务成功完成后会自动提交，失败时会自动回滚

最佳实践

1. 对于多个相关操作：总是使用事务来保证数据一致性
2. 调试技巧：在事务中可以临时添加查询语句验证数据状态
3. 错误处理：考虑添加try-catch块来处理可能的异常
4. 性能考虑：虽然事务会带来一定的性能开销，但对于关键数据操作是必要的

总结

在sqflite中执行先删除后插入的操作时，使用事务是保证数据一致性的关键。这不仅解决了数据丢失的问题，还能确保数据库在任何情况下都保持有效状态。记住，对于任何需要原子性执行的多个数据库操作，都应该考虑使用事务来包装它们。