部署Firebase Functions遇TS2339错误：Change类型无data/params属性

算力阿峰

2026-5-25

解决Firebase Functions TS2339类型错误：data/params不存在于Change<DataSnapshot>

这问题我熟！你遇到的是Firebase Functions SDK版本升级后的API变更问题——从v10版本开始，实时数据库的onUpdate（包括onCreate、onDelete等）回调参数不再是单个event对象，而是拆成了change和context两个独立参数，所以原来的event.data、event.params自然就找不到对应的类型属性啦。

具体修改步骤：

调整回调参数结构：把(event)替换成(change, context)
替换event.data：用change.before（更新前的数据快照）和change.after（更新后的数据快照）来获取数据，比如你要拿新写入的数据就用change.after.val()
替换event.params：路径中的占位参数（比如你的{uid}）要从context.params里取

你的代码修改示例：

原来的出错代码片段：

module.exports.onUserStatusChanged = functions.database
  .ref('/users/{uid}').onUpdate((event) => {
    // Get the data written to Realtime Database
    const eventStatus = event.data...
    // 后续用到event.params.uid的逻辑
  });

修改后的正确写法：

module.exports.onUserStatusChanged = functions.database
  .ref('/users/{uid}').onUpdate((change, context) => {
    // 获取更新后的用户数据
    const newUserStatus = change.after.val();
    // （可选）获取更新前的旧数据，用于对比变化
    const oldUserStatus = change.before.val();
    // 获取路径中的uid参数
    const uid = context.params.uid;

    // 你的后续业务逻辑继续写在这里...
  });