部署Cloud Functions报Function cannot be initialized错误排查

算力阿峰

2026-8-28

报错根因

这个错误是函数实例冷启动加载阶段就抛出未捕获异常导致进程直接终止，你的代码里有3个会直接触发初始化失败的问题：

核心触发点：全局作用域调用firebase.initializeApp(firebaseConfig)时，firebaseConfig变量从未被声明和赋值，代码加载阶段直接抛出ReferenceError: firebaseConfig is not defined，直接中断初始化流程。
依赖适配问题：你引入的客户端版firebase包是给浏览器/客户端环境设计的，不适合Cloud Function服务端运行环境；如果安装的是3.x版本的node-fetch，它仅支持ESM模块规范，用CommonJS的require()方式引入会直接抛导入错误，同样会终止初始化。
配置缺失：API_KEY为空字符串，即使初始化过了，调用PSI接口时也会直接返回鉴权失败错误。

另外代码逻辑还有一处运行时隐患：database.ref().set()是异步操作，但你没有等待写入完成就结束函数执行，会导致函数被Cloud Function强制回收时写入中断、数据丢失。

修复步骤

安装适配服务端的正确依赖：

npm install firebase-admin node-fetch@2

选择2.x版本的node-fetch是因为它原生支持CommonJS的require()写法，不需要额外调整模块配置。
2. 替换原有代码为以下版本，注意补全你的PSI API密钥：

// 填入你真实有效的PageSpeed Insights API密钥
const API_KEY = "替换为你的PSI_API_KEY";
const fetch = require('node-fetch');
// 服务端环境使用firebase-admin SDK，替代客户端版firebase包
const admin = require('firebase-admin');

// 若Cloud Function和Firebase属于同一个项目，initializeApp()无需传入配置，会自动读取运行时内置的服务账号凭据
admin.initializeApp();
const database = admin.database();

exports.callPSIApi = async (event, context) => {
  const message = event.data
    ? Buffer.from(event.data, 'base64').toString()
    : 'Hello, World';

  // 对传入的url做编码，避免特殊字符导致请求格式错误
  const apiCall = `https://www.googleapis.com/pagespeedonline/v5/runPagespeed?key=${API_KEY}&url=${encodeURIComponent(message)}&category=performance&strategy=mobile`;

  console.log(apiCall);
  const response = await fetch(apiCall);
  if (!response.ok) {
    const errMsg = `Request failed with status code: ${response.status}`;
    throw new Error(errMsg);
  }

  const data = await response.json();
  // 等待数据库写入完成再继续执行，避免写入中断
  await database.ref("customPath").set(data);
  console.log("Database write success");
  console.log("CALL PSI API FUNCTION RAN");
};

部署前确认：

package.json的main字段指向你的代码文件（默认为index.js）
部署时配置的入口函数名和导出的函数名一致，即callPSIApi
给Cloud Function绑定的服务账号分配Realtime Database的写入权限

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