Discord机器人Giveaway指令遇Cannot read property 'cache' of undefined报错

报错本质 #

你遇到的TypeError: Cannot read property 'cache' of undefined，出在延时抽取的逻辑链路中：discord.js 的反应数据获取链路为 频道消息缓存 -> 消息实例 -> 反应列表缓存 -> 反应实例 -> 参与用户缓存，链路中任意节点返回undefined，就会触发读取cache属性的报错。

高频触发场景 #

• 直接复用发送消息时存的内存消息实例做后续处理：setTimeout实现的延时逻辑如果运行时间较长，遇到机器人重启、网关断线重连、客户端缓存自动淘汰的场景，内存中存储的旧消息实例就会失效，基于旧实例读取reactions.cache自然会返回undefined。
• 反应匹配key错误：发送消息后添加的🎉是Unicode emoji，discord.js 内部在反应缓存中存储的key并不是表面显示的🎉字符，而是带编码转义的unicode值，硬编码key去reactions.cache.get()会取不到对应反应，返回undefined后再读取后续的用户缓存就会触发报错。
• 缺少回查接口逻辑：发送消息后没有单独存储抽奖消息的ID、对应频道ID，延时触发时直接依赖内存中残存的对象引用，没有主动从Discord接口拉取最新的消息数据。

可落地的修复参考 #

延时触发抽取逻辑时，必须先重新拉取目标消息，再匹配对应反应：

参考实现代码

// 抽奖定时任务触发后的执行逻辑
try {
  // 提前存储好抽奖对应的频道ID、抽奖消息ID，不要直接存消息实例
  const targetChannel = await client.channels.fetch(savedChannelId);
  const giveawayMsg = await targetChannel.messages.fetch(savedMessageId);
  
  // 不硬编码emoji的存储key，通过emoji名称匹配对应反应
  const partyReaction = giveawayMsg.reactions.cache.find(
    reaction => reaction.emoji.name === '🎉'
  );
  if (!partyReaction) {
    throw new Error('未匹配到对应抽奖反应记录');
  }

  // 拉取所有参与反应的用户，过滤掉机器人自身
  const participantUsers = await partyReaction.users.fetch();
  const eligibleUsers = participantUsers.filter(user => !user.bot);

  // 后续完成随机抽选逻辑
} catch (err) {
  console.error('抽奖流程执行异常', err);
}

额外避坑提示 #

• 不要把反应实例、消息实例直接存在全局变量里做跨定时任务的引用，只需要存纯字符串类型的ID值，需要使用的时候再通过接口拉取最新实例。
• 使用setTimeout实现超长延时（超过1小时）的抽奖任务时，要考虑到进程退出导致的任务丢失，可搭配持久化存储记录所有未结束的抽奖信息，启动时重新加载定时任务。
• 拉取反应用户时要设置足够的分页拉取范围，避免参与人数较多时只能拿到第一页的用户数据，导致抽选范围不全。

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