Firebase Cloud Functions部署非代码文件的最佳方式及云端构建问题咨询

一、关于阻止云端构建 #

目前没法直接关掉云端构建——这是Firebase为了保证依赖安装和构建流程一致性的强制机制，尤其是Node.js 18+这类新版本运行时，云端构建是默认触发的。别纠结关它了，换个方式处理非代码文件更靠谱。

二、部署非代码文件的最佳实践 #

1. 用package.json的files字段指定要部署的文件 #

• 在你的函数源码目录（比如functions根目录或者functions/src）建个专门的文件夹，比如assets，把二进制文件、证书全丢进去。
• 修改functions/package.json，添加files字段，明确列出要打包部署的文件/目录：

  {
    "name": "functions",
    "files": [
      "lib/**/*", // TypeScript项目的编译后代码目录
      "assets/**/*", // 你的非代码文件目录
      "package.json"
    ]
  }
  

  这样部署时，Firebase会自动把这些文件包含到部署包里，无需手动复制到编译后的文件夹。

2. 调整构建脚本，自动复制非代码文件到输出目录 #

如果是TypeScript项目，编译后代码会输出到lib，那就在package.json的build脚本里加个复制命令：

{
  "scripts": {
    "build": "tsc && cp -r assets lib/", // 适合Unix/Linux/macOS环境
    // Windows环境替换为："tsc && xcopy assets lib\\assets /E /I"
  }
}

本地构建时会把assets复制到lib，云端构建时也会执行这个脚本——因为assets在源码目录里，云端拉取代码时会拿到它，不会出现文件缺失的问题。

3. 用Firebase Storage存储大文件/动态更新的文件 #

如果二进制文件体积较大，或者需要经常更新不想重新部署函数，直接把文件传到Firebase Storage，然后在函数里用SDK读取：

• 把文件上传到Firebase Storage的指定路径，比如functions-assets/your-binary
• 函数里读取文件的示例代码：

  const { Storage } = require('@google-cloud/storage');
  const storage = new Storage();
  const bucket = storage.bucket('your-project-id.appspot.com');
  
  exports.yourFunction = async (req, res) => {
    const file = bucket.file('functions-assets/your-binary-file');
    const [fileContent] = await file.download();
    // 这里使用fileContent执行业务逻辑
  };
  

  这种方式不用把大文件打包进函数部署包，后续更新文件直接上传Storage即可，无需重新部署函数。

三、注意事项 #

• 证书这类敏感文件别提交到版本控制，用.gitignore排除，部署时通过上述方式确保能被包含到部署包中。
• 二进制文件要和云端运行时的架构兼容——云端是Linux x86_64环境，别上传Windows或ARM架构的二进制文件，否则无法正常运行。

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