如何从非/functions目录部署Firebase Cloud Functions？

Great question! I've dug into similar setups before, and here's exactly how David's approach works, plus how you can replicate it to fix your deployment errors:

核心原理 #

Firebase CLI允许你通过在firebase.json中显式定义源路径，覆盖默认的functions目录。David的仓库就是用这个配置，让CLI直接指向根目录而非默认的/functions文件夹。

Step 1: 更新你的firebase.json #

你需要在firebase.json中添加functions配置段，指定根目录作为函数的源路径。配置示例如下：

{
  // 保留你已有的hosting/storage等配置（如果有的话）
  "hosting": {
    "public": "public",
    "rewrites": [
      { "source": "**", "function": "ssr" }
    ]
  },
  "functions": {
    "source": "." // 这行告诉Firebase使用根目录作为函数源
  }
}

"."代表项目的根目录——这是让CLI在根目录而非/functions中查找函数代码的关键配置。

Step 2: 确保根目录有有效的package.json #

Firebase Functions依赖package.json来安装依赖和运行代码。要保证根目录的package.json包含必要的Firebase依赖，以及项目专属的包。以下是一个极简示例：

{
  "name": "react-ssr-firebase",
  "version": "1.0.0",
  "dependencies": {
    "firebase-functions": "^4.5.0",
    "firebase-admin": "^11.11.0",
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
    // 添加你的SSR代码需要的其他依赖
  },
  "engines": {
    "node": "18" // 匹配Firebase Functions支持的Node.js版本
  }
}

Step 3: 验证函数代码结构 #

根目录下的index.js需要像在默认/functions目录中一样导出Firebase函数。以David的SSR场景为例，代码大概是这样的：

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

exports.ssr = functions.https.onRequest((req, res) => {
  // 你的SSR逻辑代码
});

Step 4: 部署函数 #

运行你之前尝试的部署命令即可：

firebase deploy --only functions

部署报错的常见修复方案 #

如果仍然报错，检查以下常见问题：

• 缺失依赖：确保firebase-functions和firebase-admin已列在根目录的package.json中，并且执行过npm install安装它们。
• Node.js版本不匹配：Firebase Functions只支持特定Node版本——务必确认package.json的engines字段匹配支持的版本（截至2024年，推荐Node 18或20）。
• 冲突的/functions目录：如果还保留了原始的/functions文件夹，要么删除它，要么确保firebase.json明确指向根目录（如果存在歧义，CLI可能会优先使用默认文件夹）。

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