Meta Webhook API多数字段无请求触发问题排查求助

问题概述 #

我正在开发一个API以接收Meta Webhook的页面变更通知，目前处于测试模式：

• 已成功验证回调链接
• 仅少数字段（如send_cart）能正常触发后端POST请求，多数字段（如Feed相关字段）无请求到达服务器
• 后端POST控制器逻辑正常（能处理send_cart的请求）
• 已查阅官方文档、相关帖子并在Facebook开发者论坛提问，未找到匹配解决方案

服务器代码 #

控制器代码

exports.facebookWebhook = (req, res) => {
  if(req.query["hub.verify_token"] === "my_token"){
    res.status(200).send(req.query["hub.challenge"])
  }else{
    res.status(400).send({ message: "bad request" })
  }
}

exports.facebookWebhookChanges = (req, res) => {

  if (!req.body || Object.keys(req.body).length === 0) {
    console.log('Received an empty request body');
    res.status(400).send('Bad Request: Request body is empty');
    return;
  }

  console.log(req.body)

  res.status(200).send({ message: "Ok" })
}

路由代码

app.get("/api/facebook/webhook/", controller.facebookWebhook);
  app.post("/api/facebook/webhook/", controller.facebookWebhookChanges);

排查思路 #

• 确认Webhook订阅配置
  检查Facebook开发者后台的Webhook设置：

  • 确保已勾选需要监听的目标字段（如Feed相关的feed、post）
  • 确认测试应用已获取对应字段所需的权限（如pages_read_engagement、pages_show_list），测试模式下需手动添加这些权限到测试账号
  • 核对Webhook使用的Graph API版本，优先选择当前稳定版（如v18.0），旧版本可能存在字段支持限制

• 验证测试模式下的事件触发逻辑
  部分字段的事件触发依赖真实页面操作，而非仅通过测试工具模拟：

  • 针对Feed字段，需用测试账号在关联的测试页面执行真实操作（发布/编辑/删除帖子、添加评论等）
  • 确认测试账号拥有测试页面的管理员或编辑权限，无权限可能无法触发事件

• 排查请求接收端的潜在问题

  • 在facebookWebhookChanges中增加请求头部日志打印（console.log(req.headers)），确认Meta是否发送了请求但被异常处理
  • 检查服务器防火墙、反向代理（如Nginx）配置，确保Meta的IP段未被拦截，且请求大小限制足够容纳Feed事件的 payload
  • 确保后端能在15秒内返回200响应，Meta超时未收到响应会重试，多次失败后可能暂停发送该类型事件

• 查看Meta后台的Webhook事件记录
  进入Facebook开发者后台的Webhook事件页面，检查是否存在失败的请求记录，根据错误码（如超时、5xx错误）调整后端逻辑

• 注意测试工具的局限性
  Meta Webhook测试工具无法覆盖所有事件类型，尤其是依赖用户操作的字段，建议优先通过真实页面操作触发事件进行测试

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