Node.js与Google Firebase环境下嵌套查询实现问题咨询

• 查询语法使用错误：Firebase Firestore 的 array-contains 仅支持匹配「文档的数组字段中包含单个指定值」的场景，无法传入对象数组做批量匹配。原代码传入的propsToQuery是对象数组，该查询语句完全无法正常执行，且array-contains无法实现多值匹配的需求，多值单字段匹配应该使用in，匹配数组字段包含任意多值应该使用array-contains-any。
• Promise链断裂、异步执行顺序失控：原代码在data.forEach循环内部写return，该返回值不会传入外层Promise链，后续流程根本拿不到properties的查询结果；且forEach本身不会等待内部的异步操作完成，会出现接口响应已经返回、properties查询还在后台执行的时序错乱问题。
• 重复初始化与逻辑错位：每次遍历userRoles文档时，都会重新声明空的propsToQuery数组，原本要全局收集的propertyId列表会被反复重置；同时遍历单条role记录时，会重复把所有userRoles文档push到roles数组中，导致roles列表出现大量重复数据。
• 边界场景无容错：如果查询users集合时文档不存在，第一个Promise的then回调没有返回任何值，后续then拿到的data为undefined，执行data.forEach时会直接抛出未捕获的异常，最终导致接口请求超时。
• 无效的重复查询：每遍历一条role记录就会重新构造一次完全相同的properties查询，一个用户如果有N条角色记录就会触发N次重复查询，既浪费配额又拖慢响应速度。
• 冗余的async声明：第一个then回调中标注了async，但内部没有任何await操作，async关键字不会带来任何异步处理上的增益，属于冗余代码。

核心思路是把串行的嵌套查询改为分步收集参数、批量查询，用async/await替代嵌套then链提升可读性：

1. 先查询用户基础信息，对用户不存在的场景直接返回对应状态码
2. 查询用户关联的所有角色记录，直接映射为数组存储
3. 从角色记录中提取去重后的propertyId列表
4. 用一次批量查询获取所有关联的properties数据，避免循环查询
5. 组装完整的返回结构，加上全局错误捕获，保证接口能正常返回响应

优化后参考代码 #

let propertyData = {};
try {
  // 1. 查询当前认证用户的基础信息
  const userDoc = await db.doc(`/users/${req.user.uid}`).get();
  if (!userDoc.exists) {
    return res.status(404).json({ error: "目标用户不存在" });
  }
  propertyData.credentials = userDoc.data();

  // 2. 查询用户关联的所有角色记录
  const roleSnap = await db
    .collection("userRoles")
    .where("userId", "==", req.user.uid)
    .get();
  propertyData.roles = roleSnap.docs.map(doc => doc.data());

  // 3. 提取去重后的propertyId列表，过滤掉空值
  const propertyIdList = [...new Set(
    propertyData.roles.map(role => role.propertyId).filter(Boolean)
  )];

  // 4. 批量查询关联的房产数据
  let properties = [];
  if (propertyIdList.length > 0) {
    // 注意Firestore的in查询单次最多支持30个值，超过时需拆分批次查询
    const propSnap = await db
      .collection("properties")
      .where("propertyId", "in", propertyIdList)
      .get();
    properties = propSnap.docs.map(doc => doc.data());
  }
  propertyData.properties = properties;

  return res.status(200).json(propertyData);
} catch (err) {
  console.error("接口查询失败：", err);
  return res.status(500).json({ error: "服务端内部错误" });
}

• Firestore的in和array-contains-any查询都有单次最多传入30个值的限制，如果关联的propertyId数量超过30，需要把列表拆分为每批30个的小块，用Promise.all并行查询后合并结果
• 如果你的properties集合中，propertyId本身是数组字段，需要匹配数组中包含任意目标id的场景，把查询语句替换为.where("propertyId", "array-contains-any", propertyIdList)即可
• 不要在循环中直接写异步Firestore查询，需要批量查询时优先用单条聚合查询，可大幅降低Firestore的读取配额消耗

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