Flutter中Firebase实现类似MySQL LIKE的模糊搜索方案咨询

你当前的代码通过startAt和endAt实现的是前缀匹配，只能匹配字段开头的内容，要实现任意位置的模糊搜索（类似LIKE '%关键词%'）或部分单词搜索，Firestore本身没有原生的模糊查询API，可通过以下几种方案实现：

方案一：预存关键词数组（适合部分单词/分词搜索） #

如果你的搜索需求是匹配字段中的某个单词（比如搜索"apple"能匹配"red apple"），可以在文档中额外存储一个分词后的数组字段，比如descricaoKeywords，存储descricao字段拆分后的所有单词（统一转小写避免大小写匹配问题）。

步骤： #

• 新增/更新文档时，将descricao字段拆分为单词数组并存入descricaoKeywords
• 查询时使用arrayContains匹配单个关键词

代码示例： #

存储时处理关键词：

// 新增文档时处理字段
String descricao = "Red Apple Juice";
// 拆分单词、转小写、去重
List<String> keywords = descricao.toLowerCase().split(" ").toSet().toList();

await _dbCollection.add({
  "descricao": descricao,
  "descricaoKeywords": keywords,
  // 其他业务字段...
});

查询时匹配单词：

String searchText = _itemPesquisaController.text.toLowerCase();
await _dbCollection
    .where("descricaoKeywords", arrayContains: searchText)
    .get()
    .then((snapshots) {
  snapshots.docs.forEach((element) {
    ModelEstoque registro = ModelEstoque.fromJson(element.data()! as Map<String, dynamic>);
    registro.id = element.id;
    registro.filePath = "";
    _addItem(registro);
  });
});

方案二：客户端过滤（适合小规模数据集） #

如果你的数据集规模较小（比如几百条以内），可以先拉取整个集合的文档，再在客户端通过字符串匹配实现模糊搜索，模拟LIKE '%关键词%'的效果。

代码示例： #

String searchText = _itemPesquisaController.text.toLowerCase();
await _dbCollection.get().then((snapshots) {
  snapshots.docs.forEach((element) {
    ModelEstoque registro = ModelEstoque.fromJson(element.data()! as Map<String, dynamic>);
    // 忽略大小写检查字段是否包含搜索文本
    if (registro.descricao.toLowerCase().contains(searchText)) {
      registro.id = element.id;
      registro.filePath = "";
      _addItem(registro);
    }
  });
});

注意：这种方法会读取整个集合的数据，数据量大时会消耗更多带宽和客户端性能，仅适合小规模场景。

方案三：使用Cloud Functions实现服务器端模糊查询 #

通过Cloud Functions编写Node.js代码，利用正则表达式对Firestore文档进行模糊匹配，然后在Flutter中调用该云函数获取结果。

Cloud Functions代码示例（Node.js）： #

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.searchEstoque = functions.https.onCall(async (data, context) => {
  const searchText = data.searchText;
  // 生成忽略大小写的正则表达式
  const regex = new RegExp(searchText, "i");
  const snapshot = await admin.firestore()
    .collection("estoque")
    .get();
  
  const results = [];
  snapshot.forEach(doc => {
    if (regex.test(doc.data().descricao)) {
      results.push({...doc.data(), id: doc.id});
    }
  });
  return results;
});

Flutter中调用云函数： #

final HttpsCallable callable = FirebaseFunctions.instance.httpsCallable('searchEstoque');
final results = await callable.call({
  'searchText': _itemPesquisaController.text,
});

// 解析返回结果
List<ModelEstoque> registros = (results.data as List)
    .map((item) => ModelEstoque.fromJson(item as Map<String, dynamic>))
    .toList();
registros.forEach((registro) {
  registro.filePath = "";
  _addItem(registro);
});

方案四：集成全文搜索服务（适合大规模数据集） #

如果需要高性能的全文搜索、分词匹配等复杂功能，可集成专业的全文搜索服务，将Firestore的数据同步到该服务，然后通过其API实现模糊搜索。

核心步骤： #

1. 创建全文搜索索引
2. 编写Cloud Functions，在Firestore文档新增/更新/删除时自动同步数据到索引
3. 在Flutter中调用搜索服务的API获取匹配结果

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