Firebase函数报错：.once不是函数且onCreate触发失效

我尝试部署一个Firebase函数，实现新医生注册时向所有管理员账号发送通知，初始代码如下：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.newDoctorNotification = functions.database.ref("/doctors/{pushId}")
    .onCreate((snapshot, context) => {
      const newDoctorID = context.params.pushId;
      const notificationContent = {
        notification: {
          title: "New Doctor",
          body: "A new doctor just signed up! uid: " + newDoctorID,
          icon: "default",
          sound: "default",
        },
      };

      const adminTokensRef = functions.database.ref("device_tokens/admin");
      const tokens = [];

      adminTokensRef.once("value", (querySnapshot) => {
            querySnapshot.forEach((adminToken) => {
              tokens.push(adminToken.val());
            });
          });

      if (tokens.length > 0) {
        return admin.messaging().sendToDevice(tokens, notificationContent)
            .then(function(result) {
              console.log("Notification sent");
              return null;
            })
            .catch(function(error) {
              console.log("Notification failed ", error);
              return null;
            });
      }
    });

我尝试过get()、on()等多种写法，但都出现相同错误。查阅文档仅提及数据库触发器，不确定常规数据检索是否可行。

编辑补充：
更新代码通过onCreate事件提供的snapshot访问数据库节点后，错误解决，但出现新问题：向"doctors"节点添加新doctor时，函数未触发；在Google Cloud控制台点击“测试”调用函数时，snapshot.val()为null，newDoctorID为undefined，而snapshot.key为"doctors"。请问为何onCreate函数不触发？

初始代码的核心错误 #

你初始代码里有两个关键问题：

• 用functions.database()读取数据：这是错误的，functions.database仅用于定义触发器，读取数据库必须用admin.database()。
• 异步操作未等待：adminTokensRef.once("value")是异步操作，函数没等它完成就判断tokens.length，此时tokens还是空数组，导致通知逻辑不会执行。

修正后的代码（用Promise链式处理异步）：

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.newDoctorNotification = functions.database.ref("/doctors/{pushId}")
    .onCreate((snapshot, context) => {
      const newDoctorID = context.params.pushId;
      const notificationContent = {
        notification: {
          title: "New Doctor",
          body: "A new doctor just signed up! uid: " + newDoctorID,
          icon: "default",
          sound: "default",
        },
      };

      // 正确使用admin.database()访问数据
      const adminTokensRef = admin.database().ref("device_tokens/admin");

      // 返回Promise链，确保函数等待异步操作完成
      return adminTokensRef.once("value").then(querySnapshot => {
        const tokens = [];
        querySnapshot.forEach(adminToken => {
          tokens.push(adminToken.val());
        });

        if (tokens.length > 0) {
          return admin.messaging().sendToDevice(tokens, notificationContent)
            .then(result => {
              console.log("Notification sent");
              return null;
            })
            .catch(error => {
              console.log("Notification failed ", error);
              return null;
            });
        }
        return null;
      });
    });

函数不触发的排查方向 #

1. 数据写入路径不匹配 #

你的触发器监听的是/doctors/{pushId}，只有当**doctors节点下新增子节点**时才会触发。如果直接向doctors节点本身写入（比如覆盖整个节点），函数不会触发。确保新增医生时用push()方法添加子节点，比如：

// 前端新增医生的正确写法示例
firebase.database().ref('doctors').push({name: "xxx", ...其他信息});

2. 函数部署状态异常 #

• 登录Firebase控制台，进入"函数"页面，确认newDoctorNotification函数状态为"已部署"，没有报错信息。
• 查看函数详情，确认触发器路径是/doctors/{pushId}，配置正确。

3. 测试场景的问题 #

在Google Cloud控制台测试时，默认的测试数据没有模拟子节点创建的场景，导致pushId参数取不到，snapshot.key变成doctors。正确的测试方式是直接在Firebase实时数据库中手动添加一个医生子节点，然后查看函数日志是否触发，这样更符合真实场景。如果非要用控制台测试，需要构造匹配的测试体：

{
  "data": {
    "val": () => ({name: "Test Doctor"}),
    "key": "test_push_id"
  },
  "params": {
    "pushId": "test_push_id"
  }
}

额外注意事项 #

• 确保Firebase实时数据库的规则允许函数读取device_tokens/admin节点，比如设置：

{
  "rules": {
    "device_tokens": {
      "admin": {
        ".read": "true",
        ".write": "true"
      }
    }
  }
}

（生产环境建议更严格的权限控制）

• 检查函数日志：在Firebase控制台函数详情页的"日志"标签，查看是否有错误信息，帮助定位问题。

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