如何为单个Firebase触发型函数配置内存

我太懂你这种在云控制台挨个调整函数内存的麻烦了！每次改完代码重新部署后，配置又得手动改一遍，简直要命。其实完全可以在代码里直接给单个触发型函数指定内存，部署时自动生效，不用再碰控制台。下面分两种SDK版本给你讲具体操作：

如果你用的是Firebase Functions v2 SDK（推荐） #

v2的SDK把触发器配置和资源设置整合到一起了，直接在创建触发器时加memory和timeoutSeconds就行，比如你提到的Firestore文档创建触发器：

import { onDocumentCreated } from "firebase-functions/v2/firestore";

// 直接在触发器选项里配置单个函数的资源
export const myHighMemoryFunction = onDocumentCreated(
  {
    document: "your-collection/{docId}", // 你的目标文档路径
    memory: "1GB", // 这里设置你需要的内存大小，支持256MB/512MB/1GB/2GB等规格
    timeoutSeconds: 300 // 超时时间也可以一起配置
  },
  (event) => {
    // 这里写你的函数业务逻辑
    console.log("文档创建触发函数，内存已配置为1GB");
  }
);

部署这个函数时，Firebase会自动把它的内存设为1GB，不会再用默认的256MB，也不用你事后去控制台调整。

如果想给大部分函数设个默认配置，再给特殊函数单独覆盖，可以用setGlobalOptions：

import { setGlobalOptions } from "firebase-functions/v2";
import { onDocumentCreated } from "firebase-functions/v2/firestore";

// 全局默认配置，所有没单独设的函数都会用这个
setGlobalOptions({
  memory: "256MB",
  timeoutSeconds: 60
});

// 这个函数会沿用全局默认配置
export const normalFunction = onDocumentCreated(
  { document: "normal-collection/{docId}" },
  (event) => { /* 业务逻辑 */ }
);

// 这个函数单独覆盖全局配置，用1GB内存
export const highMemoryFunction = onDocumentCreated(
  {
    document: "large-data-collection/{docId}",
    memory: "1GB",
    timeoutSeconds: 300
  },
  (event) => { /* 业务逻辑 */ }
);

如果你还在使用Firebase Functions v1 SDK #

v1的话需要用runWith方法先包装资源配置，再绑定触发器：

const functions = require("firebase-functions");

// 先定义单个函数的资源配置
const highMemoryConfig = {
  memory: "1GB",
  timeoutSeconds: 300
};

// 用runWith包装配置后，再绑定Firestore的创建触发器
exports.myFunction = functions.runWith(highMemoryConfig).firestore
  .document("your-collection/{docId}")
  .onCreate((snap, context) => {
    // 函数业务逻辑
    console.log("触发函数，内存配置为1GB");
  });

为什么你的firebase.json配置没生效？ #

你之前在firebase.json里写的functions数组配置，对于v2的函数来说优先级很低，甚至可能不生效——v2 SDK设计时就更偏向于代码内配置，这样每个函数的配置和逻辑能放在一起，更清晰也不容易出错。如果一定要用firebase.json管理v2函数，需要在配置里指定source和codebase，但还是不如代码内配置直接。

备注：内容来源于stack exchange，提问作者Raul Ponzheimer