Firestore中snapshot与context读取文档ID的差异及模拟器问题

我编写了如下Cloud Functions函数：

exports.logDocId = functions.firestore
    .document("documents/" + "{documentId}")
    .onCreate(async (snapshot, context) => {
      //const docId = snapshot.id; //1.
      //const docId = context.params.documentId; //2.
      console.log(docId);
      //...
    });

请问这两种获取文档ID的方式有什么区别？我发现方式1可正常工作，但方式2在模拟器中始终输出undefined。

核心区别 #

• snapshot.id（方式1）
  直接读取触发事件的文档快照自带的ID属性，这是文档本身的固有标识，和触发器路径的定义无关，只要是针对单个文档的触发器，都能稳定拿到当前文档的ID，适用场景更通用。

• context.params.documentId（方式2）
  从触发器路径的命名占位符中提取值，只有当你在定义触发器时明确设置了对应的占位符（比如documents/{documentId}），并且触发路径完全匹配该模板时，context.params里才会生成对应的参数。如果触发器路径是集合级别的（比如documents），或者触发时的路径不匹配占位符规则，这个参数就会不存在。

模拟器返回undefined的原因 #

你的触发器路径写法本身没问题，但模拟器里出现这个情况大概率是以下原因：

1. 触发配置不匹配：手动触发时没有选择具体的文档路径，比如只选了documents集合而不是某个具体的文档，导致模拟器无法解析出documentId占位符对应的值。
2. 模拟器版本问题：旧版本的Firebase模拟器对动态路径参数的解析存在bug，建议更新Firebase CLI到最新版本后再测试。

用法建议 #

如果只是单纯需要获取当前触发的文档ID，snapshot.id是更稳妥的选择，不需要依赖路径占位符的设置；如果业务需要用到路径中的其他层级参数（比如users/{userId}/orders/{orderId}里的userId），那context.params才是必要的用法。

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