Firestore子集合插入文档时中间文档缺失致查询失效，求高效方案

问题背景 #

我在创建Firestore深层子集合的文档时，使用如下代码：

const response = await addDoc(
  collection(
    firestore,
    'stats',    // 根集合
    'dayStats', // 中间文档
    'years',    // 子集合
    '2023',     // 年份文档
    'january',  // 目标子集合
  ),
  statData
);

当中间层级结构不存在时，Firestore只会创建最终的子集合文档，而dayStats、2023这类中间节点会变成幽灵文档（控制台显示为斜体，提示"此文档不存在，不会出现在查询或快照中"）。

现在需要查询dayStats/years下的所有年份文档（预期返回[2022, 2023]），但由于这些年份都是幽灵文档，实际查询返回空数组：

const response = await getDocs(collection(
  firestore,
  RootCollections.Stats,
  'dayStats',
  'years',
));

要求解决方案尽可能高效，不使用事务（事务会让请求量增至三倍，不符合性能要求）。

核心原因 #

Firestore中的幽灵文档仅作为子集合的容器存在，本身没有任何字段数据，因此不会被集合查询返回——只有包含实际数据的文档才会出现在查询结果中。

高效解决方案 #

1. 批量条件写入创建中间文档（仅首次触发） #

在写入子集合文档前，通过批量写入+条件更新创建必要的中间文档，仅在文档不存在时执行写入，无需事务：

// 初始化批量写入
const batch = writeBatch(firestore);

// 创建dayStats文档（若不存在则创建，存在则不覆盖）
const dayStatsRef = doc(firestore, 'stats', 'dayStats');
batch.set(dayStatsRef, { created: serverTimestamp() }, { merge: true });

// 创建目标年份文档（同理）
const yearRef = doc(firestore, 'stats', 'dayStats', 'years', '2023');
batch.set(yearRef, { created: serverTimestamp() }, { merge: true });

// 执行批量提交
await batch.commit();

// 写入子集合文档
const response = await addDoc(collection(yearRef, 'january'), statData);

• 性能表现：首次创建层级时仅需2次请求（批量写入+子集合写入）；后续写入已有层级的文档时，仅需1次addDoc请求。
• 细节说明：merge: true确保不会覆盖已存在的文档数据，仅添加/更新created标识字段（也可以传空对象{}，但建议保留标识字段避免再次变成幽灵文档）。

2. 调整数据结构，扁平化存储 #

如果业务逻辑允许，放弃深层嵌套结构，将年份、月份作为字段嵌入文档：

// 扁平化结构写入
const response = await addDoc(collection(firestore, 'stats'), {
  ...statData,
  category: 'dayStats',
  year: 2023,
  month: 'january'
});

查询年份时，通过条件查询+去重实现：

const querySnapshot = await getDocs(
  query(
    collection(firestore, 'stats'),
    where('category', '==', 'dayStats'),
    select('year') // 仅查询year字段，减少数据传输
  )
);
// 去重得到唯一年份列表
const years = [...new Set(querySnapshot.docs.map(doc => doc.data().year))];

• 优势：彻底避免幽灵文档问题，写入仅需1次请求；查询逻辑更直观。
• 注意：数据量较大时，需配合Firestore索引优化查询性能；如果需要统计唯一年份，也可以使用Firestore的聚合功能（如count()）进一步优化。

3. 通过集合组查询反向推导年份 #

如果不想创建中间文档，可以利用集合组查询获取所有子集合文档，再提取父文档ID（即年份）：

// 查询所有january子集合的文档
const querySnapshot = await getDocs(collectionGroup(firestore, 'january'));
// 提取年份ID并去重
const years = [...new Set(querySnapshot.docs.map(doc => doc.ref.parent.parent.id))];

• 注意：首次执行集合组查询时，Firestore会提示创建对应的复合索引，按照提示完成创建即可。
• 优缺点：无需创建中间文档，写入仅需1次请求；但如果子集合数据量很大，查询会返回所有文档，性能较差，仅适合数据量较小的场景。

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