Firebase Realtime Database云函数event.data.ref为undefined报错排查

报错由新旧版Firebase Functions API不兼容 + 代码逻辑遗漏共同导致，不存在基础语法错误，你参考的资料基于Firebase Functions 0.x 旧版API编写，和当前普遍使用的1.0+版本SDK结构差异很大，同时代码有5处明确问题：

• 触发器参数结构错误：1.0及以上版本的Realtime Database onUpdate触发器，回调接收两个参数，第一个是包含前后快照的Change对象，第二个是存放通配符参数、触发元信息的context对象；旧版单event对象上挂载的data.ref、params属性在新版里不存在，读取ref时自然拿到undefined触发报错。
• 外层回调漏写return：触发器回调里调用内部处理函数时没有返回Promise，云函数会在同步代码执行完后直接回收运行资源，后续异步逻辑大概率被强制中断。
• Promise链漏传返回值：原代码第一个.then回调里调用了statusSnapshot.val()但没有return结果，下一个链式调用拿到的status永远是undefined，就算API匹配也无法正确判断离线状态。
• 异步操作未等待执行：Firestore的update、add方法都是异步Promise，原代码没有等待这两个操作执行完成，会出现函数退出时数据还没写入的问题。
• 自定义类型定义错误：你写的EventInterface完全不符合新版SDK的参数结构，会掩盖TypeScript的类型校验报错，反而增加排查难度。

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";
// 确保提前执行过admin初始化：admin.initializeApp()

exports.onUserStatusChanged = functions.database
  .ref("/status/{userId}")
  .onUpdate((change, context) => {
    return onUserStatusChanged(change, context, admin);
  });

async function onUserStatusChanged(
  change: functions.Change<functions.database.DataSnapshot>,
  context: functions.EventContext,
  adminInstance: admin.Admin
) {
  const usersRef = adminInstance.firestore().collection("users");
  const scheduledRef = adminInstance.firestore().collection("scheduled");
  // onUpdate触发时change.after已经是最新的节点快照，无需额外调用once拉取
  const status = change.after.val();
  const userId = context.params.userId as string;

  if (status === "offline") {
    await usersRef.doc(userId).update({ online: false });
    await scheduledRef.add({
      type: "offline",
      user: userId,
      time: Date.now(),
    });
  }
}

不建议为了适配旧资料降级firebase-functions到0.x版本，该版本已停止维护多年，存在已知的安全漏洞和稳定性问题。原代码中额外调用event.data.ref.once("value")属于冗余逻辑，触发器触发时携带的快照已经是最新值，重复拉取只会浪费数据库请求配额。

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