Firebase Cloud Functions单函数设置minInstances全局生效问题

你遇到的全局配置污染问题，核心原因是Firebase Cloud Functions的Node.js SDK中，region()、runWith()等配置方法在旧版本中会直接修改当前调用实例的默认配置，而非返回一个全新的独立配置实例。

你的代码中先定义了全局共享的regionalFunctions实例作为所有函数的区域配置基准，接着在这个实例上调用.runWith({minInstances: 1})定义manageDocs函数，这个操作直接改写了regionalFunctions实例本身的默认运行参数。后续所有通过这个共享regionalFunctions实例定义的云函数，都会自动继承被篡改的minInstances=1配置，最终出现所有函数都被设置预留实例的问题。

从你贴的部署日志也能验证这个问题：其他函数的内存配置和你之前给各函数单独设置的值一致（比如mailChimp是2GB，manageDocs是256MB），只有minInstances参数被全局统一成了1，正好是共享实例被修改后的默认值。

按照以下规则编写代码即可避免配置污染：

• 不要在全局共享的Functions配置实例上直接调用runWith()方法修改参数
• 对需要单独配置运行参数（包括minInstances、内存、超时时间）的函数，单独走完整的配置链式调用，不与其他函数共用配置实例
• 仅需要统一区域配置、不需要特殊运行参数的函数，可以使用独立的、未调用过runWith的基础区域实例

正确代码示例：

// 初始化仅供普通函数使用的基础区域实例，不要在这个实例上调用runWith修改全局配置
const baseRegionalFunctions = functions.region(cloudFunctionRegion);

// 单独为manageDocs配置参数，从最基础的functions实例开始链式调用，不污染共享实例
export const manageDocs = functions
  .region(cloudFunctionRegion)
  .runWith({
    timeoutSeconds: 9 * 60,
    memory: '256MB',
    minInstances: 1
  })
  .https.onCall(async (data, context) => {
    // 函数业务逻辑
  });

// 其他函数使用未被污染的基础实例定义，各自配置独立的参数，不会继承manageDocs的minInstances配置
export const mailChimp = baseRegionalFunctions
  .runWith({ memory: '2GB' })
  .https.onCall(/* 业务逻辑 */);

export const onCreate = baseRegionalFunctions
  .runWith({ memory: '2GB' })
  .firestore.document(/* 监听路径 */)
  .onCreate(/* 业务逻辑 */);

// 其余所有普通函数均参照上面的方式，基于baseRegionalFunctions定义即可

额外建议：

• 可以将项目内的firebase-functions依赖升级到最新稳定版，新版本已经修复了配置方法修改原实例的问题，即使临时复用实例也不容易出现配置污染
• 正式部署前可以加--dry-run参数执行部署命令，预览所有函数的配置参数，确认无误后再正式部署，避免产生预期外的费用

内容的提问来源于stack exchange，提问作者Jørgen Rasmussen