Firebase v9查询Firestore引用类型关联文档内容的实现方法

实现关联文档查询（类populate效果）方案 #

Firestore 本身没有内置的类似MongoDB的populate方法，引用类型字段的关联内容需要手动查询获取，你可以按照以下逻辑实现需求：

引用类型字段本身已经包含了完整的目标文档路径信息，可以直接传入getDoc()方法发起查询，不需要手动拼接路径：

import { getDocs, collection, getDoc } from 'firebase/firestore';

// 原有查询逻辑，获取policies集合快照
const subcollectionSnapshot = await getDocs(collection(db, 'users', 'S3casIyXxdddEAaa1YJL6UjBXLy2', 'policies'));

// 批量查询关联文档，合并返回结果
const policiesWithAssociate = await Promise.all(
  subcollectionSnapshot.docs.map(async (policyDoc) => {
    const basePolicy = policyDoc.data();
    // 并行查询两个关联文档，提升查询效率
    const [companySnapshot, storeSnapshot] = await Promise.all([
      getDoc(basePolicy.company),
      getDoc(basePolicy.store)
    ]);
    // 合并关联数据，兼容关联文档被删除的场景
    return {
      id: policyDoc.id,
      ...basePolicy,
      company: companySnapshot.exists() ? { id: companySnapshot.id, ...companySnapshot.data() } : null,
      store: storeSnapshot.exists() ? { id: storeSnapshot.id, ...storeSnapshot.data() } : null
    };
  })
);

补充说明

• 上面的代码用Promise.all做并行查询，相比串行逐个查询能大幅提升响应速度
• 可以把关联逻辑封装成通用的populate工具函数，方便多处复用：

/**
 * Firestore 通用关联查询工具
 * @param {DocumentSnapshot} doc 原始文档快照
 * @param {string[]} refFields 需要关联查询的引用字段名列表
 * @returns 合并关联数据后的完整文档
 */
async function populate(doc, refFields) {
  const rawData = doc.data();
  const refSnapList = await Promise.all(
    refFields.map(field => getDoc(rawData[field]))
  );
  refFields.forEach((field, idx) => {
    const snap = refSnapList[idx];
    rawData[field] = snap.exists() ? { id: snap.id, ...snap.data() } : null;
  });
  return { id: doc.id, ...rawData };
}

// 调用示例
const policiesWithAssociate = await Promise.all(
  subcollectionSnapshot.docs.map(doc => populate(doc, ['company', 'store']))
);

• 如果你的policies文档数量很大，这种关联方式会产生大量读请求，建议根据业务场景做适当的数据冗余，把常用的company、store字段直接冗余存储在policies文档中，减少额外查询开销。

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