如何为Python编写的Firestore第二代函数指定部署区域？

问题根源 #

你的GCP项目配置了资源位置约束（constraints/gcp.resourceLocations），禁止使用us-central1区域。Firebase默认会在该区域创建GCF上传存储桶，因此触发400错误。解决核心是显式指定项目允许的区域。

Python中指定函数区域的实现方式 #

单个函数指定区域 #

使用firebase-functions库时，通过@functions.region()装饰器为单个函数指定区域，写法对应JavaScript的链式调用逻辑：

import firebase_functions as functions

@functions.region("europe-west1")  # 替换为项目允许的区域
@functions.storage.object().on_finalize()
def my_storage_function(event):
    # 在这里编写函数逻辑
    pass

如果使用functions-framework（纯GCP Cloud Functions方式），同样通过装饰器指定区域：

import functions_framework

@functions_framework.region("europe-west1")
@functions_framework.cloud_event
def my_storage_function(event):
    # 函数逻辑
    pass

全局默认区域配置 #

如果所有函数都使用同一区域，可在firebase.json中设置全局默认值，无需逐个函数添加装饰器：

{
  "functions": {
    "source": "functions",
    "region": "europe-west1"
  }
}

部署命令临时指定 #

也可以在部署时通过命令行参数指定区域，覆盖代码或配置中的设置：

firebase deploy --only functions --region europe-west1

关键提示 #

• 务必确认指定的区域在你的项目允许的资源位置列表中，否则仍会触发类似错误。
• 单个函数的region装饰器优先级高于全局配置。

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