Firestore TypeError报错：NodeJS云函数无法读取userID属性排查

看起来你遇到的问题是没法正确从Firestore触发器路径里提取userID和notificationID参数，导致了这个类型错误。我来帮你拆解问题并给出修复方案：

错误原因分析 #

你之所以会碰到这个报错，核心问题是没有正确访问Firebase云函数触发器的上下文参数。在监听Firestore文档创建的触发器中，你在路径里定义的通配符（比如{userID}、{notificationID}），并不是存在于文档快照里，而是存储在触发器的context.params对象中。如果你的代码里尝试从某个未定义的属性去读取userID，自然会抛出“无法读取未定义属性”的错误。

修复后的完整代码 #

下面是调整后的可运行代码，我已经标注了关键修改点：

'use strict'
const functions = require('firebase-functions');
const admin = require('firebase-admin');

// 现在Firebase SDK推荐直接初始化，无需传入config参数
admin.initializeApp();

// 确保触发器路径完整，补全截断的通配符
exports.sendNotification = functions.firestore
  .document('Users/{userID}/Notifications/{notificationID}')
  .onCreate((snapshot, context) => {
    // 从context.params中正确获取路径里的用户ID和通知ID
    const userID = context.params.userID;
    const notificationID = context.params.notificationID;

    // 打印到控制台
    console.log(`检测到新通知：用户ID -> ${userID}，通知ID -> ${notificationID}`);

    // 注意：云函数必须返回Promise或一个值，避免被强制终止
    // 如果后续有异步操作（比如发送推送），记得返回对应的Promise
    return Promise.resolve();
  });

关键注意事项 #

• 路径完整性：你的原代码里路径结尾是{not...，这是截断的写法，必须补全为{notificationID}才能正确识别通配符
• 参数获取方式：一定要通过context.params.xxx来读取路径中的通配符，不要尝试从文档数据（snapshot.data()）里获取，因为userID是父文档的ID，并非子文档的字段
• Admin初始化：新版Firebase Admin SDK已经不需要手动传入functions.config().firebase，直接调用admin.initializeApp()即可自动加载项目配置
• 返回值要求：Firebase云函数的触发器回调必须返回一个Promise或有效值，否则函数会被系统强制终止，可能导致逻辑执行不完整

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