Firebase Functions（Node.js）：如何为函数设置europe-west1地域？

安全阿岳

2026-7-19

解决Firebase Functions v2部署地域配置问题

你遇到的问题是混淆了Firebase Functions v1和v2的API语法，导致地域配置写法错误。

问题根源

你的第一个代码块使用的是v2版本的API（从firebase-functions/v2/firestore导入onDocumentCreated），而第二个错误写法试图套用v1版本的functions.region()链式调用方式——但v2的API已经完全重构，不再支持这种写法。同时，代码中可能残留了未使用的onDocumentCreated变量声明，触发了ESLint的no-unused-vars警告。

正确的v2地域配置写法

v2版本的触发器函数（如onDocumentCreated）通过配置对象来指定地域、内存、超时等参数，而不是链式调用。

单函数指定地域

const {onDocumentCreated} = require("firebase-functions/v2/firestore");

exports.myFunc = onDocumentCreated(
  {
    document: "/stories/{documentId}",
    region: "europe-west1"
  },
  (event) => {
    // 你的函数逻辑代码
  }
);

全局默认地域（所有函数生效）

如果多个函数都需要部署到同一地域，可以设置全局默认配置，避免重复编写：

const {setGlobalOptions} = require("firebase-functions/v2");
const {onDocumentCreated} = require("firebase-functions/v2/firestore");

// 设置全局默认地域
setGlobalOptions({region: "europe-west1"});

exports.myFunc = onDocumentCreated("/stories/{documentId}", (event) => {
  // 你的函数逻辑代码
});