Discord.js：已知Guild ID时通过ID获取成员（cache未找到问题）

问题原因 #

• client.guilds.fetch()是异步方法，返回的是Promise，你未用await就直接访问guild.members.cache，此时guild还不是完整的Guild对象。
• 成员缓存不一定包含目标成员——Discord.js默认只会缓存已与机器人交互过的成员，未开启全成员缓存策略的话，直接查询cache会出现找不到的情况。

正确实现方式 #

方式1：直接从API获取（推荐） #

跳过本地缓存，直接调用API拉取目标成员数据，无需依赖缓存状态：

const guild = await client.guilds.fetch("gid");
const member = await guild.members.fetch("mid");
console.log(member);

方式2：优先查缓存，缓存缺失再拉取 #

如果想优先利用缓存提升响应速度，可先查缓存，找不到再请求API：

const guild = await client.guilds.fetch("gid");
let member = guild.members.cache.get("mid"); // 用get比find更高效，id是唯一标识键
if (!member) {
  member = await guild.members.fetch("mid");
}
console.log(member);

额外提醒 #

• 确保机器人拥有GUILD_MEMBERS权限，否则无法正常获取成员信息。
• 大型服务器避免开启全成员缓存，按需获取可减少API限流风险。

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