通过Cloud Functions实现Webhook写入Cloud Firestore时部署失败如何解决

• 缺失必须的依赖声明：代码中使用的firebase-functions、firebase-admin两个核心模块未在package.json中声明，部署环境无法加载对应依赖，直接触发初始化终止。
• 缺失模块导入与初始化逻辑：现有代码未导入上述两个模块，也未完成Firebase Admin的初始化，运行时调用未定义变量直接抛出异常，导致进程终止。
• 无异常兜底逻辑：未对异步写入操作做错误捕获，字段缺失、权限不足等异常都会直接导致函数崩溃。

步骤1：更新package.json添加依赖声明 #

修改package.json内容如下，添加依赖和Node版本声明：

{
  "name": "sample-http",
  "version": "0.0.1",
  "dependencies": {
    "firebase-functions": "^4.0.0",
    "firebase-admin": "^11.0.0"
  },
  "engines": {
    "node": "16"
  }
}

engines字段的Node版本可根据你使用的云函数运行时版本调整，推荐使用16/18的LTS版本。

步骤2：补充代码头部的导入和初始化逻辑 #

在现有代码最上方添加以下内容，云函数环境会自动读取内置的服务账号凭证，无需手动配置密钥：

const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp();

步骤3：补充异常捕获和请求校验逻辑（可选但强烈建议） #

优化后的完整可运行代码参考：

const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp();

// cloud-function-name = wooCommerceWebhook
exports.wooCommerceWebhook = functions.https.onRequest(async (req, res) => {
    // 拦截非POST请求
    if (req.method !== 'POST') {
        return res.status(405).end('Method Not Allowed');
    }
    try {
        const payload = req.body;
        // 校验核心字段避免读取undefined报错
        if (!payload?.billing) {
            return res.status(400).end('Invalid payload');
        }

        // Write to Firestore - People Collection
        await admin.firestore().collection("people").doc().set({
            people_EmailWork: payload.billing.email,
        });

        // Write to Firestore - Volociti Collection
        await admin.firestore().collection("volociti").doc("fJHb1VBhzTbYmgilgTSh").collection("orders").doc("yzTBXvGja5KBZOEPKPtJ").collection("orders marketplace orders").doc().set({
            ordersintuit_CustomerIPAddress: payload.customer_ip_address,
        });

        // Write to Firestore - Companies Collection
        await admin.firestore().collection("companies").doc().set({
            company_AddressMainStreet: payload.billing.address_1,
        });
        return res.status(200).end('Success');
    } catch (err) {
        console.error('Execution error: ', err);
        return res.status(500).end('Internal Error');
    }
});

步骤4：确认权限配置 #

云函数默认使用的项目ID@appspot.gserviceaccount.com服务账号需要拥有Firestore写入权限，默认已经配置，如果你之前修改过权限规则，重新确认权限配置正确即可。

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