Cloud Firestore where方法传入函数报field类型不支持错误

Cloud Firestore 的where()方法是服务端侧执行的查询接口，第一个参数仅支持传入两类值：代表文档字段名的字符串、FieldPath类型的字段路径对象，不支持传入客户端运行的闭包/回调函数。
你当前代码把Dart匿名函数(e){...}作为第一个参数传入where()，完全不符合接口的参数类型要求，因此直接抛出类型校验错误。
另外你原本的实现思路本身不成立：Firestore的查询过滤逻辑运行在云端服务器，根本无法识别、执行你写在客户端的Dart数据转换逻辑。如果绕过服务端查询先拉取全量文档再在本地过滤，会读取集合下所有文档数据，反而会产生大量不必要的读操作开销，完全违背你控制账单成本的初衷。

Firestore不支持查询过程中临时对字段值做自定义转换后再匹配，所有参与查询过滤的字段值，必须在文档写入阶段就完成格式转换并单独存储，这是由Firestore的查询机制决定的，具体操作如下：

• 写入example集合的文档时，提前通过Utils.formatPhoneNo方法把手机号处理为标准化格式，单独存为一个文档字段（比如命名为standardizedPhone）
• 查询时直接传入该标准化字段名给where()方法做服务端匹配，全程不会拉取无关文档，从根源上控制读操作账单开销，修正后的代码如下：

final authPhoneNo = Utils.formatPhoneNo(phoneNo!);
CollectionReference receiptCollection = FirebaseFirestore.instance
    .collection('example');
QuerySnapshot querySnapshot;

querySnapshot = await receiptCollection
    .orderBy('Date', descending: true)
    .where('standardizedPhone', isEqualTo: authPhoneNo)
    .get();

如果你坚持不在写入阶段预处理字段，只能选择全量拉取集合文档后在客户端本地做过滤，但这种方式会产生极高的读操作成本，文档量级稍大就会产生超额账单，完全不推荐使用，该写法仅做参考：

// 警告：该写法会拉取集合下所有文档，成本极高
querySnapshot = await receiptCollection.orderBy('Date', descending: true).get();
// 拉取完成后在客户端内存中执行过滤逻辑
final matchedResults = querySnapshot.docs.where((doc) {
  final docData = MainData.fromJson(doc.data());
  return Utils.formatPhoneNo(docData.userPhoneNo!) == authPhoneNo;
}).toList();

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