Firebase Cloud Functions部署失败：package.json无exports主定义报错

核心原因 #

你遇到的错误是Firebase SDK版本冲突导致的：

• 同时安装了模块化的Firebase 9.x和旧版的firebase/app 0.8.4，两者导出结构不兼容
• Cloud Functions操作Firebase Storage应使用Firebase Admin SDK，而非客户端Firebase SDK，当前依赖搭配混乱

具体修复步骤 #

1. 清理冲突依赖
   卸载所有冲突的Firebase相关包：

   npm uninstall firebase firebase/app
   

   只保留Admin SDK和Cloud Functions所需依赖：

   npm install firebase-admin@latest firebase-functions@latest @google-cloud/storage@latest express express-handlebars
   

2. 修正代码初始化逻辑
   Cloud Functions中无需初始化客户端Firebase SDK，仅需正确初始化Admin SDK：

   const functions = require('firebase-functions');
   const admin = require('firebase-admin');
   const express = require('express');
   const engines = require('express-handlebars');
   
   // 新版Admin SDK无需手动传入配置，会自动读取环境变量
   admin.initializeApp();
   
   const app = express();
   app.engine('hbs', engines.handlebars);
   app.set('views', './views');
   app.set('view engine', 'hbs');
   
   // 示例：使用Admin SDK操作Storage
   const storage = admin.storage();
   const bucket = storage.bucket();
   

3. 校验package.json依赖
   确保package.json中无旧版冲突依赖，示例如下：

   "dependencies": {
     "firebase-admin": "^11.11.0",
     "firebase-functions": "^4.5.0",
     "@google-cloud/storage": "^7.7.0",
     "express": "^4.18.2",
     "express-handlebars": "^7.1.2"
   }
   

4. 重新部署
   清理旧依赖后重新安装并部署：

   rm -rf node_modules package-lock.json
   npm install
   firebase deploy --only functions
   

关键注意事项 #

• Cloud Functions操作Firebase服务（含Storage）必须用Admin SDK，禁止使用客户端firebase包
• 保持所有Firebase相关依赖版本匹配，避免新旧版本混用
• 新版Admin SDK初始化无需手动传入functions.config().firebase，自动读取环境配置

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