Discord.js v14移除服务器成员角色报错：无法读取undefined属性

错误原因分析 #

1. 使用guild.members.cache.get(discordid)报错：
   这个错误说明member是undefined——目标成员不在机器人的本地成员缓存里。缓存仅包含当前在线、或机器人启动后活跃过的成员，离线很久的成员不会被缓存。

2. 使用guild.members.fetch(discordid)报错：
   fetch是异步操作，返回的是Promise对象，若不用await等待它执行完成，直接访问member.roles会因为Promise没有该属性报错，后续的some方法自然也无法调用。

修正后的代码 #

const roleIDs = ["1048196394688725053","1051123574955589632"];
// 先检查目标服务器是否存在
const guild = client.guilds.cache.get(guildId);
if (!guild) {
  console.log("找不到目标服务器");
  return;
}

try {
  // 用await等待fetch完成，确保拿到真实的成员对象
  const member = await guild.members.fetch(discordid);
  if (!member) {
    console.log("找不到目标成员");
    return;
  }

  if (result[0]) {
    if (JSON.stringify(e) === '-1') {
      // 检查成员是否持有目标角色
      const hasTargetRole = member.roles.cache.some(role => roleIDs.includes(role.id));
      if (hasTargetRole) {
        // 直接传入roleIDs数组批量移除，比回调写法更高效
        await member.roles.remove(roleIDs);
        console.log("已移除目标角色");
      }
      // member.setNickname(`[${result.id}]-${charname.replaceAll("_"," ")}`)
    }
  }
} catch (error) {
  console.error("处理过程出错:", error);
}

关键修正点 #

• 增加服务器、成员的存在性检查，避免因对象不存在触发后续报错
• 对guild.members.fetch()添加await，确保拿到实际成员对象而非Promise
• 移除角色时直接传入roleIDs数组，Discord.js支持批量操作，代码更简洁
• 加入try/catch捕获异步操作中的错误，方便排查问题

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