Firebase Functions第二代函数部署失败求助

核心问题分析 #

你遇到的Cannot find module 'firebase-functions/v2/database'错误，本质是当前依赖的firebase-functions版本（3.6.1）不支持第二代函数的v2 API，同时Node.js版本（10）也不符合第二代函数的运行要求。

分步解决方案 #

1. 升级核心依赖包 #

在functions目录下执行以下命令，升级到支持v2 API的最新稳定版依赖：

npm install firebase-functions@latest firebase-admin@latest

更新后的package.json依赖段示例（版本号以实际安装为准）：

"dependencies": {
  "firebase-admin": "^12.0.0",
  "firebase-functions": "^14.0.0"
}

2. 升级Node.js版本 #

第二代Firebase Functions要求Node.js最低版本为14（官方推荐18），修改package.json的engines字段：

"engines": {
  "node": "18"
}

同时确保本地开发环境已安装Node.js 18或更高版本。

3. 适配代码规范（可选） #

你的代码混用了ES模块导入和CommonJS语法，建议统一为TypeScript风格，同时第二代函数初始化无需传入functions.config().firebase：

import * as functions from 'firebase-functions';
import { onValueUpdated, increment } from "firebase-functions/v2/database";
import * as admin from 'firebase-admin';

admin.initializeApp();

4. 处理依赖漏洞 #

升级依赖后执行npm audit查看漏洞详情：

• 若为低风险漏洞且不影响功能，可暂时忽略；
• 若存在高风险漏洞，执行npm audit fix即可，官方修复方案通常是安全的，若有顾虑可先查看修复详情再操作。

5. 重新构建部署 #

先执行TypeScript编译：

npm run build

再部署函数：

firebase deploy --only functions

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