Firestore GetDocument()获取不存在文档时致应用崩溃问题咨询

嘿，我完全懂你现在的糟心情况——明明Firestore官方文档说读取不存在的文档应该返回null，结果你的应用直接崩了，这确实让人困惑。我来帮你拆解下问题根源，再给你靠谱的修复方案。

首先先明确官方文档的说明：

注意：如果docRef指向的位置不存在文档，返回的文档将为null。

这里的“返回null”并不是说会抛出致命错误，而是指文档快照的data()方法会返回null，或者快照对象的exists属性会是false。你的崩溃大概率是因为没有做空值判断就直接访问文档数据，或者用了强制解包（比如Swift里的!、Kotlin里的!!），导致null被强行操作引发崩溃。

常见错误代码示例（以JavaScript为例） #

// 错误写法：跳过空值判断直接取字段
async function doReadDeepDocument() {
  const docRef = db.collection("users").doc("non-existent-id");
  const docSnap = await docRef.get();
  // 文档不存在时，docSnap.data()返回undefined，直接访问字段会触发 TypeError
  const username = docSnap.data().username;
  console.log(username);
}

修复后的正确代码 #

只需要加上文档存在性的判断，再安全访问数据：

async function doReadDeepDocument() {
  const docRef = db.collection("users").doc("non-existent-id");
  const docSnap = await docRef.get();
  
  if (docSnap.exists()) {
    // 文档存在时再安全获取数据
    const userData = docSnap.data();
    const username = userData?.username; // 可选链进一步避免字段不存在的问题
    console.log("用户名称：", username);
  } else {
    // 文档不存在时的处理逻辑，比如提示用户或执行空状态逻辑
    console.log("目标文档不存在，已返回null处理");
  }
}

如果是Swift语言的场景（同样的问题逻辑） #

错误示例（强制解包导致崩溃）：

func doReadDeepDocument() {
    let docRef = Firestore.firestore().collection("users").document("non-existent-id")
    docRef.getDocument { (document, error) in
        if let error = error {
            print("获取文档出错：\(error)")
            return
        }
        // 文档不存在时，document?.data()返回nil，强制解包!会触发崩溃
        let username = document!.data()!["username"] as! String
        print(username)
    }
}

修复后的Swift代码：

func doReadDeepDocument() {
    let docRef = Firestore.firestore().collection("users").document("non-existent-id")
    docRef.getDocument { (document, error) in
        if let error = error {
            print("获取文档出错：\(error)")
            return
        }
        // 先判断文档是否存在，避免空值操作
        guard let document = document, document.exists else {
            print("目标文档不存在，已返回null处理")
            return
        }
        // 安全获取字段，用可选绑定避免强制解包
        if let username = document.data()?["username"] as? String {
            print("用户名称：\(username)")
        } else {
            print("字段不存在或类型不匹配")
        }
    }
}

核心总结 #

官方说的“返回null”是指文档数据为null，但快照对象本身是存在的。崩溃的本质是你没有处理这个null场景，直接对null进行了属性访问或强制解包。只要在读取数据前先检查docSnap.exists()（或对应语言的存在判断），再安全地处理数据，就能避免崩溃啦。

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