添加Firebase Trigger Mail扩展后doc.data()返回空值问题排查

核心问题定位 #

报错Value for argument "documentPath" is not a valid resource path的直接原因是：你尝试用undefined值作为Firestore文档路径创建docRef，根源出在id字段的获取逻辑上。

细节拆解 #

1. id字段的错误解构：
   Firestore文档的id是文档本身的标识，存储在doc.id属性中，而非doc.data()返回的字段集合里。你的代码从data里解构id，但如果文档数据中没有id字段，就会得到undefined，导致db.collection("subway").doc(id)等价于doc(undefined)，触发路径无效报错。

2. doc.data()日志显示为空的误导：
   你提到logger.log("data: ", data)显示为空，但JSON.stringify(data)能输出完整数据，这是Firestore SDK的特性——doc.data()返回的是带有特殊原型链的对象，直接用logger.log打印时，部分环境会只显示对象的自有可枚举属性以外的内容，而JSON.stringify会序列化所有可枚举属性，所以能看到真实数据。这不是数据丢失，只是日志显示的问题。

修复步骤 #

1. 修正id的获取逻辑 #

把从data解构id改为直接使用doc.id：

// 原代码
const {
  id, // 此处会拿到undefined（若文档无id字段）
  name,
  openHour,
  closeHour,
  status,
  notified,
  lastTotalCount,
} = data;

const docRef = db.collection("subway").doc(id);

// 修正后
const {
  name,
  openHour,
  closeHour,
  status,
  notified,
  lastTotalCount,
} = data;

const docId = doc.id; // 直接取文档自身的id
const docRef = db.collection("subway").doc(docId);

2. 增加空值校验（可选但推荐） #

为避免后续因name为空导致Storage调用出错，在获取文件前增加校验：

if (!name) {
  logger.error(`文档${docId}的name字段为空，跳过Storage检查`);
  continue;
}
const [files] = await bucket.getFiles({ prefix: `${name}` });

3. 优化日志输出 #

为准确查看数据，修改日志打印方式：

// 原代码
logger.log("data: ", data);

// 优化后
logger.log("data: ", JSON.stringify(data));

为什么添加Trigger Mail扩展后才出现问题？ #

该扩展本身不会直接导致Firestore数据读取异常，大概率是以下间接原因：

• 扩展安装后，云函数的部署环境（如Node.js版本、SDK依赖版本）发生变化，使得原本隐藏的id字段缺失问题暴露；
• 扩展安装过程中，可能无意中修改了Firestore权限规则，但从你能通过JSON.stringify拿到完整数据来看，这个可能性较低。

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