Drift 2.24.0 版本发布：JSONB支持与数据库交互增强

2025-06-17 22:09:50作者：齐添朝

项目简介

Drift 是一个现代化的 Dart 数据库访问库，它提供了类型安全、编译时检查的 SQL 查询能力，同时支持 Flutter 和纯 Dart 项目。作为 SQLite 的高级封装，Drift 让开发者能够以更符合 Dart 语言习惯的方式处理数据库操作，同时保持高性能和灵活性。

版本亮点

1. 增强的 JSONB 支持

在 2.24.0 版本中，Drift 显著改进了对 JSONB 格式的支持。JSONB 是 SQLite 中存储 JSON 数据的二进制格式，相比普通 JSON 具有更好的查询性能和存储效率。

新版本引入了 TypeConverter.jsonb 方法，允许开发者直接将 Dart 对象存储为 SQLite 的 JSONB 格式。这种方式避免了额外的编码转换步骤，提高了数据存储和检索的效率。

同时，团队对原有的 JSON 支持进行了优化，将 TypeConverter.json 标记为弃用，推荐使用新的 TypeConverter.json2 方法。这一改进解决了之前版本中对象映射到 JSON 时可能发生的双重编码问题，使得数据转换更加高效。

2. 拦截器作用域控制

数据库操作拦截器是 Drift 提供的一个强大功能，允许开发者在查询执行前后插入自定义逻辑。在 2.24.0 版本中，新增了 runWithInterceptor 方法，使得拦截器的应用可以限定在特定的代码块中。

这一改进带来了更精细的控制能力，开发者现在可以：

只在特定业务逻辑中应用性能监控拦截器
临时启用调试日志而不影响全局
针对关键操作添加额外的安全检查

3. 生成器与工具链改进

Drift 的代码生成器在这一版本中也获得了多项增强：

全面支持 analyzer 7.x 系列版本，保持与最新 Dart 工具链的兼容性
添加了对 SQLite 3.48 新特性的分析支持
修复了全文搜索(FTS5)表相关的空安全分析问题，同时通过将版本提升至 3.48 来保持向后兼容性

技术细节解析

JSONB 转换的最佳实践

在新版本中使用 JSONB 转换非常简单。以下是一个典型示例：

class UserConverter extends TypeConverter<User, String> {
  const UserConverter();
  
  @override
  User fromSql(String fromDb) => User.fromJson(jsonDecode(fromDb));
  
  @override
  String toSql(User value) => jsonEncode(value.toJson());
}

// 使用jsonb转换器
@DriftDatabase()
class MyDatabase extends _$MyDatabase {
  // 使用jsonb转换器
  MyDatabase() : super(_openConnection());
  
  @override
  List<TypeConverter> get typeConverters => [
    const UserConverter().jsonb, // 使用jsonb格式
  ];
}

拦截器作用域控制示例

新的 runWithInterceptor 方法使用方式如下：

final db = MyDatabase();

// 只在当前块中使用拦截器
await db.runWithInterceptor(
  () async {
    // 这里的查询会受到拦截器影响
    await db.someQuery();
  },
  interceptors: [mySpecialInterceptor],
);

// 这里的查询不受拦截器影响
await db.anotherQuery();