如何通过Firebase Twilio发送消息扩展获取消息状态？回调函数未触发

API 探路者

2026-7-6

解决Firebase触发器扩展无法接收消息状态更新的问题

核心排查与修复步骤

核对Status Callback URL准确性
确认控制台配置的URL与云函数实际触发地址完全匹配，包括区域、项目ID、函数名的拼写，Firebase云函数URL格式通常为https://<region>-<project-id>.cloudfunctions.net/<function-name>，避免大小写或路径参数错误。
配置云函数调用权限
给处理状态回调的云函数添加FCM服务账号（fcm@system.gserviceaccount.com）的调用权限，赋予其cloudfunctions.invoker角色，确保FCM有权触发你的函数。

发送消息时显式启用回执请求
仅控制台配置URL不够，发送消息时必须在请求中指定回执参数，示例代码如下：

// Node.js发送消息示例
admin.messaging().send({
  token: "<设备Token>",
  notification: { title: "测试消息" },
  android: {
    delivery_receipt_requested: true
  },
  apns: {
    payload: {
      aps: { "content-available": 1 }
    },
    headers: {
      "apns-push-type": "alert",
      "apns-topic": "<你的Bundle ID>"
    },
    delivery_receipt_requested: true
  }
});

检查云函数日志
前往Firebase控制台「函数」→「日志」，搜索目标函数的调用记录：
- 若有请求日志但报错，根据错误信息（如参数解析失败、权限不足）修复代码或配置；
- 若无请求日志，说明FCM未向函数发起回调，需重新核对URL和扩展配置。
验证FCM扩展配置
确认Firebase触发器扩展已启用「消息状态回调」功能，且回调目标选择了你的云函数，部分扩展需手动勾选MESSAGE_STATUS类事件类型。
手动测试函数连通性
用curl或Postman向云函数URL发送模拟的FCM状态回调请求，测试函数是否正常响应：
```
{
  "messageId": "<消息ID>",
  "messageStatus": "delivered",
  "registrationToken": "<设备Token>",
  "timestamp": "1620000000000"
}
```
若函数能正常处理，说明问题出在FCM与函数的连通环节；若无响应，排查函数代码逻辑错误。