无法访问Firebase Firestore中的嵌套文档字段怎么办？

可能原因及对应解决方案 #

• 字段名大小写/拼写不匹配
  Firestore字段名严格区分大小写，检查代码里的items、billing_thresholds与Firestore文档中的实际字段名是否完全一致（包括大小写、下划线/驼峰格式差异）。

• 数据类型不匹配
  确认Firestore中items是数组类型而非Map对象：

  • 如果是Map类型，不能用数组索引[0]访问，需改用Object.values(afterData.items)[0]获取第一个元素。
  • 打印完整数据结构验证实际内容：

    console.log('完整文档数据:', JSON.stringify(afterData));
    

    通过输出确认items的真实结构。

• TypeScript类型定义限制
  若使用自定义类型，确保类型包含嵌套字段结构，避免类型推断导致的访问限制：

  interface OrderDocument {
    items: Array<{
      billing_thresholds: Record<string, any>; // 根据实际字段定义具体类型
    }>;
    // 其他文档字段
  }
  const afterData = change.after.data() as OrderDocument;
  

• 优化可选链防护逻辑
  避免因items本身不存在或为空数组导致undefined，增强访问的安全性：

  const productKey = afterData?.items?.[0]?.billing_thresholds;
  

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