如何在Firebase Cloud Functions中查询集合内指定字段匹配的文档

将业务逻辑统一放在Firebase Cloud Functions中处理的做法完全合理，核心优势如下：

• 无需多端重复开发同一份逻辑，后续迭代只需修改服务端代码即可全端同步生效，大幅降低维护成本
• 业务逻辑不会暴露在客户端侧，数据校验、权限控制等逻辑的安全性更高
• 可按需裁剪返回给客户端的数据字段，减少无效数据传输

你之前编写的代码存在语法错误：Firestore的Node.js Admin SDK没有find方法，该语法属于MongoDB的查询用法，Firestore条件查询需要使用where方法构造规则。
完整的Cloud Function实现示例如下：

const functions = require('firebase-functions');
const admin = require('firebase-admin');
// 初始化Admin SDK，Cloud Function运行环境会自动读取内置的服务账号配置，无需手动传参
admin.initializeApp();

// 定义可被客户端直接调用的HTTPS Callable函数
exports.getUserGroups = functions.https.onCall(async (data, context) => {
  // 权限校验：只有已登录的用户可以调用该接口
  const userId = context.auth?.uid;
  if (!userId) {
    throw new functions.https.HttpsError('unauthenticated', '用户未登录，无法查询群组数据');
  }

  try {
    // 构造查询条件：查询groups集合中playerId等于当前登录用户id的所有文档
    const groupQuery = admin.firestore().collection('groups').where('playerId', '==', userId);
    const querySnapshot = await groupQuery.get();

    // 将查询结果处理为数组返回
    const groupList = [];
    querySnapshot.forEach(doc => {
      // 合并文档id和文档字段内容，也可根据业务需要只返回指定字段
      groupList.push({
        groupId: doc.id,
        ...doc.data()
      });
    });

    return {
      success: true,
      data: groupList
    };
  } catch (err) {
    throw new functions.https.HttpsError('internal', '查询群组数据失败', err.message);
  }
});

• 如果groups集合的数据量较大，建议给playerId字段添加索引，查询时如果Firebase控制台弹出索引创建提示，按指引操作即可
• 客户端侧可以直接使用Firebase SDK对应平台的Callable函数调用方法访问该接口，无需手动封装HTTP请求逻辑

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