Firebase Cloud Function onRequest未触发问题排查求助

我负责的Firebase Cloud Function paymentCallback 出现异常，这是我的第一个自由职业项目，目前给我和客户都带来了困扰。该函数原本用于接收JSON格式的支付Payload，提取数据后写入Firestore文档以确认支付状态。此前运行正常，但昨日起无法确认支付状态——应写入Firestore的数据未被写入。线上日志仅显示WE ARE ABOUT TO BEGIN，无后续函数执行相关日志。本地使用Firebase模拟器测试时，函数能正常接收Payload并完成Firestore写入操作。

相关代码 #

// paymentCallback 函数实现
exports.paymentCallback = functions.https.onRequest(async (req, res) => {
  console.log('WE ARE ABOUT TO BEGIN');
  try {
    const payload = req.body;
    // 提取支付数据并写入Firestore
    const paymentRef = admin.firestore().collection('payments').doc(payload.transactionId);
    await paymentRef.set({
      status: payload.status,
      amount: payload.amount,
      customerId: payload.customerId,
      processedAt: admin.firestore.FieldValue.serverTimestamp()
    });
    res.status(200).send('Payment status updated');
  } catch (error) {
    console.error('Error handling payment callback:', error);
    res.status(500).send('Internal server error');
  }
});

支付Payload示例 #

{
  "transactionId": "txn_789XYZ",
  "status": "success",
  "amount": 149.99,
  "customerId": "cust_123ABC"
}

线上日志片段 #

WE ARE ABOUT TO BEGIN

项目配置信息 #

• Firebase CLI版本：13.1.0
• Node.js版本：18.x
• Firestore安全规则：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /payments/{paymentId} {
      allow write: if true; // 临时开放权限用于测试
    }
  }
}

排查建议 #

1. 检查服务账号权限：线上Cloud Function默认使用的服务账号（PROJECT_ID@appspot.gserviceaccount.com）可能缺少Firestore写入权限。前往Firebase控制台的「IAM与管理员」页面，确认该账号是否拥有「Cloud Datastore User」或「Editor」角色。
2. 添加Payload日志排查：在console.log('WE ARE ABOUT TO BEGIN')后立即添加console.log('Raw request body:', req.rawBody)和console.log('Parsed payload:', req.body)，重新部署函数后触发支付回调，查看线上日志是否能正常打印Payload内容——若解析失败，会直接进入catch块但可能因未捕获异常导致日志缺失。
3. 验证函数超时设置：线上函数默认超时60秒，若Firestore写入或Payload处理耗时接近阈值，可能导致函数被强制终止。前往Cloud Functions控制台，将该函数的超时时间临时调整为90秒测试。
4. 核对依赖版本：对比本地package.json与线上部署的依赖版本（可通过Cloud Functions控制台的「源代码」标签查看），确保firebase-admin、firebase-functions等核心依赖版本一致，避免版本差异导致的兼容性问题。
5. 测试异常捕获逻辑：在本地刻意构造错误Payload（如缺失必填字段），验证catch块是否能正常打印错误日志。若线上未捕获到异常，可能是函数未正确处理Promise rejection，导致进程崩溃无日志输出。

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