You need to enable JavaScript to run this app. Firestore文档调用.get()方法返回undefined导致函数执行崩溃问题
优惠活动
大模型
产品
解决方案
定价
更多

Firestore文档调用.get()方法返回undefined导致函数执行崩溃问题

Firestore文档引用调用get()方法返回undefined触发运行时异常

问题背景

  • 本次为开源项目贡献代码阶段的函数重构工作,涉及的用户保存逻辑已经在生产环境稳定运行1个多月,无线上故障反馈
  • 逐行排查后定位到的异常链路:
    • 执行firestore.collection('users').doc(userData.uid)生成的文档引用userRef为有效值,不存在undefined问题
    • 对userRef调用get()方法、经await等待后拿到的返回值为undefined
    • 程序在执行userDoc.exists判断时直接崩溃,触发读取undefined对象属性的运行时错误

故障代码片段

export async function saveUserInFirestore(userData) {
  // 文档引用初始化正常,无undefined返回
  const userRef = await firestore.collection('users').doc(userData.uid);
  // get()调用后拿到的userDoc为undefined
  const userDoc = await userRef.get();

  if (userDoc.exists) {
    return { ...userDoc, exists: true };
  } else {
    const { uid, first_name: initialFirst, last_name: initialLast, displayName, pictureUrl } = userData;
    const updatedUserObject = {
      uid,
      initialFirst,
      initialLast,
      displayName,
      pictureUrl,
      createdAt: firebase.firestore.FieldValue.serverTimestamp(),
    };
    return userRef.set(updatedUserObject).then(() => updatedUserObject);
  }
}

常见排查方向

  • 检查Firebase SDK版本是否匹配:本地开发环境下引入的模块化Firestore实例,可能与代码中全局挂载的firebase对象版本不一致,导致文档引用对象的方法逻辑不兼容,get()无法正常返回封装好的DocumentSnapshot Promise对象
  • 排查是否存在测试mock拦截:重构过程中临时添加的Firestore mock实现,如果没有为文档引用对象的get()方法实现返回带exists属性的快照值的逻辑,会导致真实SDK调用被错误拦截
  • 排查异步上下文异常:本地开发插件/工具如果对Promise链做了异常劫持(比如调试插件篡改异步执行上下文),会截断get()方法返回的Promise值,最终await操作拿到undefined

内容的提问来源于stack exchange,提问作者Zamkie

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 05:45:04