Firestore Where查询返回全部记录及大小写处理异常问题

这是因为Firestore的字符串比较是严格基于Unicode码点的区分大小写比较，这也是你看到不同大小写输入返回完全不同结果的核心原因。

问题根源解析 #

Unicode编码里，大写字母的码点范围是U+0041到U+005A，而小写字母是U+0061到U+007A——也就是说所有大写字母的码点都小于小写字母。举个具体的例子：

• "Eth"的起始字符E（U+0045），比所有小写字母开头的字符串（比如"bit..."里的b是U+0062）的码点都小
• 而"eth"的起始字符e（U+0065），只比部分小写字母开头的字符串大

如果你的查询逻辑是类似where("name", ">=", 查询文本)或者前缀查询（startAt(查询文本).endAt(查询文本 + "\uf8ff")），那么：

• 输入"Eth"时，集合里几乎所有文档的name字段值的码点都大于等于"Eth"，所以返回全部条目
• 输入"eth"时，只有name字段值大于等于"eth"的文档才会被匹配，也就是你看到的11条结果

解决方案：实现不区分大小写的查询 #

最直接且高效的方案是存储一个小写化的冗余字段，查询时统一将输入转为小写，再对这个冗余字段进行查询：

1. 存储文档时同步保存小写字段

假设你用JavaScript，存储逻辑可以改成这样：

// 添加/更新文档时，同时保存name的小写版本
const saveDocument = async (docData) => {
  const docWithLowercase = {
    ...docData,
    nameLower: docData.name.toLowerCase() // 新增小写字段
  };
  await db.collection("yourCollection").add(docWithLowercase);
};

2. 查询时统一转为小写并匹配

const searchByName = async (queryText) => {
  const lowerQuery = queryText.toLowerCase();
  // 用小写字段做前缀查询，匹配所有以输入文本（小写）开头的文档
  const querySnapshot = await db.collection("yourCollection")
    .where("nameLower", ">=", lowerQuery)
    .where("nameLower", "<=", lowerQuery + "\uf8ff")
    .get();

  // 处理查询结果
  querySnapshot.forEach(doc => {
    console.log(doc.id, "=>", doc.data());
  });
};

这样不管你输入"Eth"还是"eth"，都会转为"eth"去匹配nameLower字段，就能得到一致且符合预期的查询结果了。

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