GRDB.swift 中 FTS5Pattern 的混合条件查询优化方案

在 SQLite 全文搜索功能中，FTS5 是一个强大的扩展模块。GRDB.swift 作为 Swift 语言的 SQLite 工具库，提供了 FTS5Pattern 类型来简化全文搜索查询的构建。然而，当前版本的 FTS5Pattern 在构建复杂查询条件时存在一些局限性。

现有功能分析

GRDB.swift 目前提供了两种基本的 FTS5Pattern 初始化方法：

1. init?(matchingAnyTokenIn:) - 构建 OR 条件查询，如 "foo OR bar"
2. init?(matchingAllTokensIn:) - 构建 AND 条件查询，如 "foo AND bar"

这些方法能够满足简单的查询需求，但当需要构建混合条件的复杂查询时，如 "(foo OR bar) AND other"，现有的 API 就显得力不从心了。

问题场景

在实际开发中，我们经常需要构建包含嵌套逻辑的查询条件。例如：

• 搜索包含"苹果"或"香蕉"且必须包含"水果"的文档
• 查找匹配多个关键词组合中的任意一个，但同时排除某些词语的结果

这些场景需要将 AND 和 OR 条件灵活组合使用，而当前的 FTS5Pattern 初始化方法无法直接支持这种需求。

解决方案探讨

开发者提出了两种改进方案：

方案一：组合模式构建器

extension FTS5Pattern {
   static func allOf(_ patterns: [FTS5Pattern]) -> FTS5Pattern 
   static func anyOf(_ patterns: [FTS5Pattern]) -> FTS5Pattern 
}

这种方案允许开发者先构建简单的条件模式，然后通过逻辑组合函数将它们组合成复杂查询。例如：

FTS5Pattern.allOf([
   .init(matchingAnyTokenIn:"苹果 香蕉"),
   .init(matchingAllTokensIn:"水果"),
])

这种方式保持了类型安全，且语法清晰易读。

方案二：原始模式字符串支持

另一种方案是提供直接使用原始 FTS5 模式字符串的初始化方法，作为高级用法的逃生舱口。这给了开发者最大的灵活性，但牺牲了部分类型安全性。

现有替代方案

实际上，GRDB.swift 已经提供了一个解决方案，虽然使用上稍显不便：

let pattern1: FTS5Pattern = ...
let pattern2: FTS5Pattern = ...
let combinedRawPattern = "(\(pattern1.rawPattern)) OR (\(pattern2.rawPattern))"
let combinedPattern = try db.makeFTS5Pattern(rawPattern: combinedRawPattern, forTable: "document")

这种方法需要数据库连接来验证模式字符串的有效性，确保在查询执行前就能发现语法错误。虽然设计初衷良好，但在实际使用中确实带来了不便。

改进方向建议

基于以上分析，可以考虑以下改进方向：

1. 添加组合模式构建器方法，提供更友好的 API
2. 放宽原始模式字符串的验证要求，允许无连接构建
3. 保留现有验证机制，但提供可选的无验证初始化方法

这些改进将使 GRDB.swift 的全文搜索功能更加灵活强大，满足更复杂的业务场景需求。对于需要构建复杂搜索条件的应用来说，这将显著提升开发体验和代码可读性。