You need to enable JavaScript to run this app. discord.js v12升级后ready事件用client.users.cache.get发DM报undefined错误怎么办
优惠活动
大模型
产品
解决方案
定价
更多

discord.js v12升级后ready事件用client.users.cache.get发DM报undefined错误怎么办

discord.js v12 版本升级后启动发DM报错的解决方法

核心问题成因

你百分百确认用户ID正确依然报错,这个问题根本和ID准确性无关,是discord.js v12对用户缓存规则做了破坏性调整导致的:

  • v11版本中,bot启动完成时会自动把所有与bot关联的用户预加载到全局缓存,直接通过client.users.cache.get()就能拿到完整的用户实例,旧代码因此可以正常运行
  • v12版本改为懒加载缓存机制,没有被主动拉取过、没有进入当前缓存范围的用户,哪怕ID完全正确,client.users.cache.get()也会返回undefined。你在这个undefined对象上调用send方法,自然会抛出“无法读取send属性”的类型错误。

可直接替换的修复代码

把原来直接读缓存的逻辑换成官方提供的异步用户拉取方法,同时补上异常捕获,避免接口异常、用户拒收DM时触发你碰到的UnhandledPromiseRejectionWarning告警:

client.on('ready', async () => {
  console.log('Malosa SentryBot started successfully');
  try {
    // 拉取目标用户:缓存存在就直接复用,不存在就自动从Discord接口获取用户实例
    const targetUser = await client.users.fetch('43437XXXXXX25418');
    await targetUser.send('Blabla');
  } catch (err) {
    console.error('启动DM发送失败:', err);
  }
});

容易踩的坑

  • client.users.fetch()是异步方法,所在的ready回调必须加上async关键字,否则会拿到未解析的Promise对象,依然无法正常调用send方法
  • 拉取用户成功不代表DM一定能发出去,如果目标用户关闭了私信接收权限、触发Discord接口限流,错误会被try/catch捕获,不会再弹出无处理的Promise拒绝警告
  • 不要为了提前加载所有用户刻意开启已经废弃的fetchAllMembers配置,这个参数会大幅拖慢bot启动速度,按需通过fetch方法拉取目标对象的效率要高得多

内容的提问来源于stack exchange,提问作者Tranq

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 09:15:00