iOS平台CBLite全文检索(FTS)异常问题求助

1. 左括号(搜索无结果的解决方法 #

左括号是FTS查询语法的特殊字符（用于分组逻辑），直接作为搜索词会被解析为语法而非字面量，导致无法匹配内容。解决方式有两种：

• 精确短语匹配：将包含左括号的搜索词用双引号包裹，让FTS将其视为完整短语而非语法符号。Swift示例代码：

  let searchTerm = "(example"
  let query = QueryBuilder
      .select(SelectResult.all())
      .from(DataSource.database(database))
      .where(Expression.property("fts_column").match("\"\(searchTerm)\""))
  

• 转义特殊字符：对左括号添加反斜杠转义（代码中需双重转义，因为字符串会解析反斜杠）。Swift示例代码：

  let escapedTerm = searchTerm.replacingOccurrences(of: "(", with: "\\(")
  let query = QueryBuilder
      .select(SelectResult.all())
      .from(DataSource.database(database))
      .where(Expression.property("fts_column").match(escapedTerm))
  

2. 短横线-搜索缓慢的解决方法 #

短横线默认会被CBLite的unicode61等分词器识别为单词分隔符，导致A-Something被拆分为A和Something两个独立词。搜索时FTS需要匹配两词组合，遍历更多数据从而变慢。解决步骤：

• 修改分词器配置：创建FTS索引时，调整分词器的分隔符参数，将短横线排除在分隔符列表之外，让带短横线的词被视为完整词汇。Swift示例代码：

  // 创建FTS索引时指定分词器选项，移除短横线作为分隔符
  let ftsConfig = FullTextIndexConfiguration(["target_column"])
      .usingTokenizer(.unicode61, options: [
          .separators("!@#$%^&*()_+[]{}|;:,.<>?") // 列表中不包含短横线
      ])
  try database.createIndex(withName: "custom_fts_index", configuration: ftsConfig)
  

• 重建索引：如果已有旧索引，需删除后重新创建，确保新分词规则应用到已有数据。
• 验证分词效果：可通过SQL语句确认分词结果：

  SELECT token FROM fts_index WHERE token MATCH 'A-Something';
  

  返回单个A-Something token即说明配置生效。

注意事项 #

• 所有FTS查询代码需适配新分词规则，搜索带短横线的词时直接作为完整词查询即可。
• 若使用旧版CBLite，部分分词器选项可能不支持，建议升级至最新稳定版。

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