如何在discord.js中获取消息emoji反应计数及排查reactions返回undefined问题

问题根因与对应修复操作 #

• 修正单条消息拉取的参数配置
  默认调用channel.messages.fetch(消息ID)时，会优先读取本地缓存的简化版消息快照，这类快照不会自动挂载完整的reactions属性，直接访问就会返回undefined。需要强制跳过本地缓存，从Discord接口拉取完整的消息实体，修改后的代码如下：

  // 强制拉取完整消息实体，不使用本地缓存的简化快照
  const embedMessage = await channel.messages.fetch(row.get('messageID'), {
    force: true
  });
  

  之前调试出现“仅返回频道全部消息列表”的现象，本质是fetch方法因为参数格式不对，触发了批量拉取频道最近消息的逻辑，没有按单条消息的规则返回目标实体。
• 核对客户端的Intent权限配置
  即使拉取了完整消息，如果机器人没有开启GuildMessageReactions权限intent，Discord接口会在返回数据时直接剔除所有reactions相关字段，这种情况就算消息上挂了再多反应，拿到的消息对象里也找不到对应属性。需要在客户端初始化时显式加入该权限：

  const client = new Client({
    intents: [
      // 保留你原有配置的所有intent项
      GatewayIntentBits.GuildMessageReactions
    ]
  });
  

• 绕开消息对象缓存的兜底取数逻辑
  按上面配置后如果还是取不到反应集合，可以直接通过反应管理器拉取指定emoji的反应计数，不依赖消息对象上挂载的缓存属性：

  // 拉取目标消息下的指定emoji反应，直接获取计数
  const targetReaction = await embedMessage.reactions.fetch(目标emoji的标识);
  const reactionCount = targetReaction.count;
  

  因为你提到机器人自身会提前给目标消息加反应，这里拉取时不存在权限不足的问题，只需要注意Discord接口的反应数据同步有短时间延迟，不需要额外做权限校验。
• 排除定时任务场景下的缓存失效问题
  你的取数逻辑是在定时任务到期后触发，这种跨小时/跨重启的场景下，之前代码里缓存的embed常量、旧版消息引用早就因为缓存淘汰被清空，不能依赖这类旧引用取实时反应数据，所有取数操作都必须走实时fetch拉取的流程，不能复用消息发送时的旧对象引用。

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