如何在Python Cloud Function中写入非默认Firestore数据库

问题描述 #

当前使用Python开发Firebase Cloud Functions，默认数据库初始化代码运行正常：

cred = credentials.Certificate("db_key.json")
app = initialize_app(cred)
db = firebase.client(app)

需要切换至非默认数据库写入，但未找到规范方法。曾尝试两种方案：

1. 修改私有属性：db._database = 'testing-db'，可运行但属于非规范用法
2. 直接导入Firestore Client类：

import from google.cloud.firestore import Client  # 存在语法错误

db = Client(credentials=cred, database=dbName)

该方法本地可行，但部署云函数时触发错误：

"error": "Functions codebase could not be analyzed successfully. It may have a syntax or runtime error"
同时，不清楚如何获取初始化Firebase客户端所需的database-url。

正确解决方案 #

方案1：使用Firebase Admin SDK规范指定数据库ID #

通过firestore.client()方法直接传入database参数，这是官方支持的规范用法，无需修改私有属性：

import firebase_admin
from firebase_admin import credentials, firestore

cred = credentials.Certificate("db_key.json")
app = firebase_admin.initialize_app(cred)
# 初始化指定非默认数据库的客户端
db = firestore.client(app, database='testing-db')

方案2：修正直接导入Client的语法错误 #

若坚持使用google.cloud.firestore.Client，首先修正导入语句的语法错误（原代码多写了import），同时确保部署时配置正确：

from google.cloud import firestore
from firebase_admin import credentials

cred = credentials.Certificate("db_key.json")
# 初始化指定数据库的Client
db = firestore.Client(credentials=cred, database='testing-db')

部署时需注意：

• 确保db_key.json文件已包含在部署包中（在firebase.json的functions配置里指定包含该文件）
• 确认服务账号拥有目标非默认数据库的读写权限

关于database-url的说明 #

Firestore数据库URL的格式为：https://<你的项目ID>.firestore.googleapis.com/databases/<数据库ID>/documents
例如，项目ID为my-firebase-project，数据库ID为testing-db，则URL为：
https://my-firebase-project.firestore.googleapis.com/databases/testing-db/documents
不过使用方案1的database参数更为简便，无需手动构造URL。

部署注意事项 #

• 确保所有依赖包已正确声明在requirements.txt中，包括firebase-admin和google-cloud-firestore
• 若使用自定义服务账号密钥，需在firebase.json中配置函数部署时包含该文件：

{
  "functions": {
    "source": "functions",
    "ignore": [
      "node_modules",
      ".git",
      "firebase-debug.log",
      "firebase-debug.*.log"
    ],
    "include": ["db_key.json"]
  }
}

内容的提问来源于stack exchange，提问作者P. Luchs