Firebase调用getDoc查询单个文档失败如何解决

首次使用Firebase做数据库查询，目标是读取单个指定文档，已编写实现代码，调试数小时无法正常运行，推测是易修复的小问题但暂未定位错误点。

现有实现代码 #

export function GetSingleTicket() {
  const docRef = doc(db, "tickets", "hg7G40Lhwh9HVwqe4mlB");

  getDoc(docRef).then((doc) => {
    console.log(doc.data(), doc.id);
  });
}

Firestore文档结构参考 #

你的代码基础逻辑没有语法错误，按以下步骤逐一排查即可解决问题：

• 首先补全错误捕获和文档存在性判断，这是你当前代码最明显的缺失：getDoc请求如果被安全规则拦截、出现网络错误，没有catch的话不会抛出明确报错；如果查询的文档不存在，直接调用doc.data()会返回undefined甚至触发报错。修改后的代码如下：

export function GetSingleTicket() {
  const docRef = doc(db, "tickets", "hg7G40Lhwh9HVwqe4mlB");

  getDoc(docRef).then((doc) => {
    if (doc.exists()) {
      console.log(doc.data(), doc.id);
    } else {
      console.log("文档不存在，请核对集合名、文档ID是否完全匹配（注意Firestore路径大小写敏感）");
    }
  }).catch((error) => {
    console.error("文档查询失败：", error);
  });
}

• 核对路径正确性：对照文档树截图，确认根集合名称确实是tickets，目标文档ID确实是hg7G40Lhwh9HVwqe4mlB，不要出现多余空格、大小写错误。
• 检查Firestore安全规则配置：如果你还没接入Firebase Auth做登录鉴权，默认的生产规则会拦截所有未授权的读写请求。本地调试阶段可以临时将规则设置为测试模式，确认查询正常后再按业务需求补充权限逻辑：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.time < timestamp.date(2025, 12, 31);
    }
  }
}

注意：上述测试规则存在公开访问风险，仅可用于本地开发调试，正式上线前必须替换为符合安全要求的权限规则

• 核对初始化实例：确认代码中引用的db是通过当前项目的Firebase配置初始化得到的Firestore实例，初始化参数要和Firebase控制台给出的项目参数完全一致，不要跨项目引用实例。

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