开发Facebook Messenger Bot遇400错误：Page节点无messages字段

我之前开发Messenger Bot的时候也踩过这个坑，咱们一步步拆解问题、解决它：

核心问题定位 #

你遇到的(#100) Tried accessing nonexisting field (messages) on node type (Page)错误，本质是请求的API URL写错了：Facebook Messenger发送消息的接口不是直接对Page ID操作messages字段，而是需要用/me/messages的专用端点（这里的me会自动映射到你的Page ID，前提是请求携带的令牌权限正确），错误的URL直接触发了400状态码。

具体修复步骤 #

1. 修正POST请求的URL #

确保你的Axios请求URL严格遵循Graph API规范，正确格式如下：

const apiUrl = `https://graph.facebook.com/v18.0/me/messages?access_token=${process.env.PAGE_ACCESS_TOKEN}`;

注意：把v18.0替换成你当前使用的最新API版本，Facebook会定期淘汰旧版本，用最新稳定版能避免不少兼容性问题。

2. 检查请求体参数格式 #

发送消息的请求体必须包含recipient和message两个核心字段，示例结构如下：

const requestBody = {
  recipient: { id: "<USER_PSID>" }, // 这里填从Webhook收到的用户页面范围ID
  message: { text: "这是机器人的回复内容！" }
};

如果要发送按钮、图片等富消息，也要严格按照官方要求的参数格式编写，不要遗漏必填项。

3. 验证Page Access Token的权限 #

确保你的Page令牌拥有以下核心权限：

• pages_messaging：这是发送Messenger消息的必备权限
• 确认令牌未过期，且是绑定到目标Page的有效令牌

你可以在Facebook开发者平台的令牌验证工具里，查看令牌的权限列表和有效性。

4. 完整的Axios请求示例 #

把以上修正点整合起来，完整的请求代码大概是这样：

const axios = require('axios');

async function sendBotReply(userId, replyText) {
  try {
    const apiUrl = `https://graph.facebook.com/v18.0/me/messages?access_token=${process.env.PAGE_ACCESS_TOKEN}`;
    const requestBody = {
      recipient: { id: userId },
      message: { text: replyText }
    };

    const response = await axios.post(apiUrl, requestBody);
    console.log("消息发送成功：", response.data);
  } catch (error) {
    console.error("发送消息失败：", error.response?.data || error.message);
  }
}

额外排查点 #

• 如果还是报错，检查是否手动修改过请求头，确保Content-Type是application/json（Axios默认会为JSON请求体自动设置，但若手动修改过需要确认）
• 确认使用的用户ID是从Webhook接收的有效PSID，不要误用用户的个人Facebook ID

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