Node.js编写的Firebase Cloud Functions读取Firestore数据报错：user_id未定义

你碰到的这个TypeError提示user_id未定义，核心原因是获取Firestore文档路径通配符的方式不正确。在新版本的Firebase Cloud Functions SDK中，文档路径里的{user_id}这类通配符参数，需要从context对象的params属性中提取，而不是直接从事件对象中获取。

错误写法示例（大概率是你当前的问题所在） #

很多开发者会误把事件对象当成参数来源，比如这样写：

exports.sendNotification = functions.firestore.document("Users/{user_id}/Notifications/{notification_id}").onWrite((ev) => {
  // 错误：尝试直接从事件对象ev中获取user_id
  const userId = ev.user_id;
  // ...后续逻辑
});

正确写法调整 #

你需要修改函数的参数结构，加入context参数，然后从context.params中提取路径通配符：

'use strict';
const admin = require('firebase-admin');
const functions = require('firebase-functions');
const serviceAccount = require("./serviceAccountKey.json");

// 初始化Admin SDK（如果是通过Firebase CLI部署，也可以简化为admin.initializeApp()）
admin.initializeApp({
  credential: admin.credential.cert(serviceAccount),
  databaseURL: "https://your-project-id.firebaseio.com" // 替换为你的数据库URL
});

exports.sendNotification = functions.firestore.document("Users/{user_id}/Notifications/{notification_id}").onWrite((change, context) => {
  // 正确：从context.params中获取路径里的通配符参数
  const userId = context.params.user_id;
  const notificationId = context.params.notification_id;

  // 示例：用userId去Firestore获取用户数据
  return admin.firestore().collection('Users').doc(userId).get()
    .then(userDoc => {
      if (!userDoc.exists) {
        console.log(`用户ID ${userId} 对应的文档不存在`);
        return null;
      }
      const userData = userDoc.data();
      // 这里处理你的通知发送逻辑
      console.log(`成功获取用户数据：`, userData);
      return null;
    })
    .catch(error => {
      console.error(`获取用户数据失败：`, error);
      return null;
    });
});

额外注意事项 #

• SDK版本兼容：如果你的Functions SDK是v1.0及以上，onWrite事件的参数固定为(change, context)；旧版本SDK用的是event参数，那时是event.params.user_id，但现在推荐使用最新SDK写法。
• 路径大小写匹配：Firestore的文档路径是大小写敏感的，确保你的代码中写的Users和Firestore里的集合名称完全一致（比如不要写成users）。
• Admin初始化简化：如果你的函数是通过Firebase CLI部署到项目中的，不需要手动引入serviceAccountKey.json，直接调用admin.initializeApp()即可，Firebase会自动注入凭据。

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