Messenger机器人Webhook报错：Cannot read properties of undefined (reading 'forEach')

你的代码出现的错误，直接原因是**entry.messaging的值为undefined**，导致无法调用forEach方法。具体可能由以下几种情况导致：

1. entry变量本身未定义 #

这说明你没有正确获取到Messenger webhook payload里的entry字段：

• 可能未对webhook请求体做JSON解析，拿到的是原始字符串而非对象
• 请求体格式不符合Messenger webhook的标准结构
• 变量名拼写错误（比如把entry写成了其他名称）

2. 未正确处理entry的数组结构 #

Messenger的webhook payload中，entry是一个数组（可能包含多个条目），每个数组元素才是带有messaging字段的对象。你的代码直接使用entry.messaging，相当于在数组对象上查找messaging属性，这必然会得到undefined。正确的做法是先遍历entry数组，再处理每个元素的messaging：

// 修正后的结构示例
payload.entry.forEach(function(entryItem) {
  entryItem.messaging.forEach(async function(webhookEvent) {
    // 你的事件处理逻辑
    if ("read" in webhookEvent) {
      console.log("Got a read event");
      return;
    } else if ("delivery" in webhookEvent) {
      console.log("Got a delivery event");
      return;
    } else if (webhookEvent.message && webhookEvent.message.is_echo) {
      console.log("Got an echo of our send, mid = " + webhookEvent.message.mid);
      return;
    }
  });
});

3. 部分entry元素不含messaging字段 #

虽然大部分Messenger事件的entry都会包含messaging，但某些特殊事件（比如页面订阅状态更新）的entry可能没有这个字段。这种情况下，需要先判断messaging是否存在再调用forEach：

payload.entry.forEach(function(entryItem) {
  if (entryItem.messaging) { // 先判断是否存在
    entryItem.messaging.forEach(async function(webhookEvent) {
      // 你的事件处理逻辑
    });
  }
});

你的原代码： #

entry.messaging.forEach(async function (webhookEvent) {
    // Discard uninteresting events
    if ("read" in webhookEvent) {
      console.log("Got a read event");
      return;
    } else if ("delivery" in webhookEvent) {
      console.log("Got a delivery event");
      return;
    } else if (webhookEvent.message && webhookEvent.message.is_echo) {
      console.log(
        "Got an echo of our send, mid = " + webhookEvent.message.mid
      );
      return;
    }
});

报错信息： #

entry.messaging.forEach( /*#__PURE__*/function () {
TypeError: Cannot read properties of undefined (reading 'forEach')

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