Discord.js v13 ready函数中通过ID获取成员返回undefined问题求助

问题成因 #

• Discord.js v13 对网关权限和缓存逻辑做了不兼容v12的调整：
  1. 强制要求在Discord开发者后台的Bot设置页面开启Server Members Intent（服务器成员意图），未开启该意图时，本地仅缓存Bot自身、触发交互事件的成员，其余成员默认不会进入本地缓存。
  2. 移除了v12版本的fetchAllMembers初始化配置项，默认不会主动拉取全量服务器成员存入本地缓存，仅当成员触发消息、交互等事件时才会被动态加入缓存。
• 你遇到的「遍历可输出所有成员、但单独get返回undefined」的特殊表现，本质是缓存同步存在时间差：ready事件触发时，全量成员的分块同步尚未完成，此时调用get访问指定ID成员会返回不存在，遍历操作则会输出所有已同步到本地的成员。

解决方法 #

因你说明当前场景无法使用members.fetch()，可按以下优先级调整：

1. 确认已开启网关意图：首先在Discord开发者后台开启Server Members Intent，同时在Client初始化代码中显式声明该意图：

const { Client, Intents } = require('discord.js');
const client = new Client({
  intents: [
    Intents.FLAGS.GUILDS,
    Intents.FLAGS.GUILD_MEMBERS, // 必须添加该意图
    // 其余你业务需要用到的其他意图
  ]
});

2. 调整代码执行时机：不要直接在ready事件回调中立即执行成员查询，改为监听guildMembersChunk事件，确认目标服务器的成员全量同步完成后再执行查询：

const targetGuildId = "你的目标服务器ID";
client.on('guildMembersChunk', (chunk, guild) => {
  // 当目标服务器的成员分块全部同步完成时触发后续逻辑
  if(guild.id === targetGuildId && chunk.index + 1 === chunk.chunkCount) {
    const targetMember = guild.members.cache.get("目标成员ID");
    // 在这里执行你的业务逻辑
  }
});

3. 调整缓存策略（仅推荐成员数量小于1万的小服务器使用）：如果需要长期全量缓存所有成员，可修改Client初始化的缓存配置，取消成员缓存的大小限制：

const client = new Client({
  intents: [/* 你用到的所有意图 */],
  makeCache: (manager) => {
    if (manager.name === 'GuildMemberManager') {
      return { maxSize: Infinity };
    }
    // 其余类型缓存保持默认策略
    return manager.makeCache();
  }
});

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