如何在Node.js环境下通过Cloud Function对Firestore数据库执行CRUD操作？

1. 正确初始化Firebase Admin SDK #

在Cloud Functions环境中，无需手动传入配置参数，Firebase CLI会自动注入环境配置，直接调用admin.initializeApp()即可。你之前尝试的admin.initializeApp(functions.config().firebase)是旧版本写法，现已废弃。

正确初始化代码：

const functions = require("firebase-functions");
const admin = require("firebase-admin");

// 仅需调用一次，放在函数外部
admin.initializeApp();

2. 区分Firestore与Realtime Database API #

你代码中使用的admin.database()是操作Realtime Database的API，要操作Firestore必须用admin.firestore()，这是核心错误点。

3. 完整Webhook接收器示例（更新Firestore） #

以下是HTTP类型Cloud Function作为Webhook接收器，接收请求后更新Firestore数据的完整代码：

const functions = require("firebase-functions");
const admin = require("firebase-admin");

admin.initializeApp();
const db = admin.firestore();

// HTTP型Cloud Function，作为Webhook接收器
exports.handleWebhook = functions.https.onRequest(async (req, res) => {
    // 可选：验证Webhook请求合法性（如校验签名，需根据提供商要求实现）

    try {
        // 从请求体中提取Webhook数据
        const webhookData = req.body;
        
        // 更新Firestore指定文档
        await db.collection("tmp_list").doc("1uMW9ED3YGMfERHZiKJc").update({
            lastUpdated: admin.firestore.FieldValue.serverTimestamp(),
            receivedData: webhookData
        });

        // 返回成功响应给Webhook发送方
        res.status(200).send("Firestore数据更新完成");
    } catch (error) {
        functions.logger.error("更新Firestore失败", error);
        res.status(500).send("内部服务器错误");
    }
});

4. 常见问题排查 #

• 初始化报错时，检查是否通过Firebase CLI部署函数，本地测试需确保安装firebase-functions和firebase-admin依赖，并启动本地模拟器firebase emulators:start。
• 确认Cloud Function服务账号拥有Firestore读写权限（默认配置下权限充足，除非手动修改过Firestore安全规则）。
• 必须用异步/await处理Firestore异步操作，确保函数在异步任务完成后再返回响应。

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