Firebase Cloud Functions部署报错：functions.database.ref不是函数求助

这个报错functions.database.ref is not a function是因为Firebase Cloud Functions SDK从v10版本开始全面切换到了模块化API，原来的命名空间式调用（functions.database.ref(...)）已经被废弃。下面分两种场景给出解决办法：

场景1：使用v10+版本的Firebase Functions SDK #

如果你的package.json里firebase-functions版本是^10.0.0及以上，需要改用新的模块化写法：

1. 修改导入语句：

// 替换原来的 const functions = require("firebase-functions");
const { onValueCreated } = require("firebase-functions/v2/database");
const { initializeApp: initializeAdminApp } = require("firebase-admin/app");
const { getMessaging } = require("firebase-admin/messaging");

// 初始化Firebase Admin（如果需要）
initializeAdminApp();

2. 修改触发器定义：

// 替换原来的 functions.database.ref('/user/{pushId}').onCreate(...)
exports.sendPushNotification = onValueCreated("/user/{pushId}", (event) => {
  // 获取新增的数据快照
  const snapshot = event.data;
  // 获取路径参数pushId
  const pushId = event.params.pushId;
  
  // 你的FCM推送逻辑代码
  const message = {
    notification: { title: "新数据提醒", body: "有新的用户数据写入" },
    token: "目标设备的FCM令牌"
  };
  return getMessaging().send(message);
});

场景2：继续使用v9及以下版本的SDK #

如果不想修改代码结构，可以回退到兼容旧写法的版本：

1. 卸载当前版本，安装v9.x的firebase-functions和对应版本的firebase-admin：

npm uninstall firebase-functions firebase-admin
npm install firebase-functions@9 firebase-admin@11

2. 保持原来的代码写法不变，确认导入语句正确：

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

admin.initializeApp();

exports.sendPushNotification = functions.database.ref('/user/{pushId}').onCreate((snapshot, context) => {
  // 你的原有逻辑代码
});

额外检查项 #

• 确认package.json里的依赖版本符合上述场景要求
• 部署前先本地运行firebase emulators:start测试代码，提前发现语法或逻辑错误
• 确保函数中的FCM推送逻辑正确获取目标设备令牌，避免后续推送失败

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