如何创建Firestore子集合并向其中添加内容？子集合写入失败如何解决？

现存代码的核心问题 #

• SDK方法名调用错误：Firestore 8.x及后续Web端JavaScript SDK，文档引用的标准方法为.doc()，不存在.document()接口。代码中db.collection("Stories").document(story).collection("Chapters")这行执行时会直接抛出方法不存在的TypeError，直接阻断子集合的写入流程，这是主文档能正常写入、子集合无法创建内容的最直接原因，是从旧版Firestore SDK迁移时的常见语法混淆。
• 写入流程无顺序约束：当前代码中主集合写入、子集合写入两个请求是并行触发的，没有等待主文档写入完成就发起子集合请求，在弱网环境下很容易因为时序问题出现路径校验失败、写入偶发丢失的问题。
• 输入参数无校验：直接将用户输入的故事标题作为文档ID使用，如果输入内容包含斜杠、空值、长度超过1500字节，Firestore会直接拒收写入请求。
• 错误反馈缺失：原代码的错误捕获只在控制台打印，没有给页面端的用户反馈，排查问题时很难快速定位失败原因。

修复后的可运行代码 #

document.getElementById("submitButton").addEventListener("click", function() {
  const storyTitle = document.getElementById("storyTitle").value.trim();
  const chapterTitle = tinymce.get("writeTitle").getContent().trim();
  const chapterContent = tinymce.get("chapterContent").getContent();
  const tipEl = document.getElementById("testing");

  // 基础非空校验，避免无效请求触发报错
  if (!storyTitle || !chapterTitle || !chapterContent) {
    tipEl.innerText = "输入内容不能为空，请检查后重试";
    return;
  }
  addStory(storyTitle, chapterTitle, chapterContent);
});
    
function addStory(story, chapter, theContent) {
  const db = firebase.firestore();
  // 统一定义文档、集合引用，减少重复写长路径导致的语法错误
  const storyDocRef = db.collection("Stories").doc(story);
  const chapterColRef = storyDocRef.collection("Chapters");
  const tipEl = document.getElementById("testing");

  tipEl.innerText = `正在提交：${story} / ${chapter}`;

  // 链式执行写入流程：先完成主文档写入，再写入子集合内容
  storyDocRef.set({
    title: story,
    createTime: firebase.firestore.FieldValue.serverTimestamp()
  }).then(() => {
    console.log("主文档写入成功");
    // 主文档写入完成后，再向Chapters子集合添加章节文档
    return chapterColRef.add({
      title: chapter,
      content: theContent,
      createTime: firebase.firestore.FieldValue.serverTimestamp()
    });
  }).then(() => {
    tipEl.innerText = "内容提交成功";
    console.log("子集合章节写入成功");
  }).catch((error) => {
    console.error("写入流程异常：", error);
    tipEl.innerText = `提交失败：${error.message}`;
  });
}

补充注意事项 #

• Firestore的集合不需要手动提前创建，只要向指定路径的子集合写入第一条文档，系统会自动生成完整的层级路径，没有单独的创建集合接口。
• 如果修复代码后依然出现写入失败，需要检查Firestore安全规则：当前登录用户是否对Stories/{storyId}/Chapters/{chapterId}路径具备写权限，避免权限拦截导致的静默写入失败。

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