Discord.js遍历成员数组移除角色时roles返回undefined如何解决

算力阿峰

2026-10-6

问题原因

报错的核心原因就是message.guild.members.cache.get(competition[x].id)返回了undefined，才会出现读取roles属性失败的问题，你的判断是对的。
出现这种差异是因为discord.js默认不会缓存服务器全量成员，只有触发过相关交互（发消息、进频道等）的成员才会进入缓存，其他命令运行正常只是刚好对应操作的成员当时都在缓存中。

修复方案

1. 基础修复（加判空避免打断执行）

先判断成员是否存在再操作，同时加异常捕获避免单个操作失败打断整个循环：

const TARGET_ROLE_ID = '775547730901729330';
for (let x = 0; x < competition.length; x++) {
  const member = message.guild.members.cache.get(competition[x].id);
  if (!member) continue;
  member.roles.remove(TARGET_ROLE_ID)
    .catch(err => console.error(`移除角色失败，用户ID：${competition[x].id}`, err));
}

2. 完整修复（解决成员不在缓存的问题）

首先去Discord开发者后台给Bot开启SERVER MEMBERS INTENT权限，初始化Client时将GuildMembers加入意图列表，再在执行移除逻辑前主动拉取全量成员缓存：

const TARGET_ROLE_ID = '775547730901729330';
// 先拉取全量服务器成员到缓存，注意外层函数需要加async
await message.guild.members.fetch();

for (let x = 0; x < competition.length; x++) {
  const member = message.guild.members.cache.get(competition[x].id);
  if (!member) {
    console.log(`未找到用户${competition[x].name}（ID：${competition[x].id}），该成员可能已离开服务器`);
    continue;
  }
  await member.roles.remove(TARGET_ROLE_ID)
    .catch(err => console.error(`移除${competition[x].name}的角色失败：`, err));
}