如何转换Flutter Firestore传入数据字符以实现搜索功能

最优方案：预存小写字段（推荐） #

Firestore的查询不支持直接对字段进行大小写转换操作，最高效的方式是在存储数据时额外保存一个小写版本的名称字段，后续查询直接基于这个字段进行匹配。

步骤1：更新数据存储逻辑 #

在添加或更新Products文档时，同步存入nameLowercase字段，值为Name的小写形式：

// 添加新商品示例
_firestore.collection("Products").add({
  "Name": "Apple",
  "nameLowercase": "apple", // 自动转为小写存储
});

// 更新商品示例
_firestore.collection("Products").doc(productId).update({
  "Name": "Banana",
  "nameLowercase": "banana",
});

步骤2：修改查询逻辑 #

将查询条件改为基于nameLowercase字段，同时添加isLessThanOrEqualTo和\uf8ff实现前缀匹配（确保只返回以搜索文本开头的结果）：

StreamBuilder(
    stream: _firestore.collection("Products")
        .where("nameLowercase", isGreaterThanOrEqualTo: SearchText.toLowerCase())
        .where("nameLowercase", isLessThanOrEqualTo: SearchText.toLowerCase() + '\uf8ff')
        .snapshots(),
    builder: (BuildContext context, snapshot) {
      if (!snapshot.hasData) {
        return const Text("No data");
      }
      return ListView.builder(
        itemCount: snapshot.data!.docs.length,
        itemBuilder: (context, index) {
          return Card(
            child: ListTile(
              title: Text(snapshot.data!.docs[index].data()["Name"]),
            ),
          );
        },
      );
    }
),

备选方案：客户端过滤（不推荐） #

如果无法修改数据存储结构，可以在客户端获取所有文档后再进行过滤，但这种方法会拉取整个Products集合的数据，数据量大时性能极差，仅适合小规模数据场景：

StreamBuilder(
    stream: _firestore.collection("Products").snapshots(),
    builder: (BuildContext context, snapshot) {
      if (!snapshot.hasData) {
        return const Text("No data");
      }
      // 客户端过滤：将商品名称转为小写后匹配搜索文本
      final filteredDocs = snapshot.data!.docs.where((doc) {
        final productName = doc.data()["Name"].toString().toLowerCase();
        return productName.contains(SearchText.toLowerCase());
      }).toList();
      
      return ListView.builder(
        itemCount: filteredDocs.length,
        itemBuilder: (context, index) {
          return Card(
            child: ListTile(
              title: Text(filteredDocs[index].data()["Name"]),
            ),
          );
        },
      );
    }
),

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