如何在Firebase Cloud Functions v2中调用Firestore的increment方法？

在 Firebase Admin SDK v2（对应 Cloud Functions v2）中，FieldValue 已改为独立导出的模块成员，不再挂载在 admin.firestore 或 Firestore 实例上。正确的调用方式是直接从 firebase-admin/firestore 导入 FieldValue：

const { getFirestore, FieldValue } = require("firebase-admin/firestore");

// 生成递增操作对象
const incrementByOne = FieldValue.increment(1);

// 完整示例：更新文档指定字段
const db = getFirestore();
await db.collection("your-collection").doc("target-doc").update({
  count: incrementByOne
});

版本差异说明 #

• v1 中通过 admin.firestore.FieldValue 访问，是因为当时 SDK 采用单例式结构，所有 Firestore 相关 API 都挂载在 admin.firestore 下。
• v2 转向模块化设计后，FieldValue、Timestamp 等工具类改为独立导出，需要显式导入才能使用，以此优化依赖加载逻辑。

内容的提问来源于stack exchange，提问作者lurning too koad