Discord.js在指定guild中移除用户对应role身份组的问题求解

问题原因 #

• 调用guild.members.cache.get()返回undefined的核心原因是目标用户没有被加载到本地缓存中：Discord.js 默认不会主动拉取服务器全量成员数据到缓存，只有触发过交互（比如发消息、调用过成员相关接口）的用户才会出现在缓存里，你从API拉取的用户ID对应的成员之前没有产生过交互，自然查不到。
• 小概率是你从接口拿到的user.user字段不是字符串类型的有效用户ID，或者前后带多余空格、类型为数字导致匹配失败。

解决方案 #

第一步：开启必要的网关意图 #

你需要在代码初始化Discord Client时开启GuildMembers意图，否则无法拉取服务器成员数据：

// discord.js v14 写法
const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({
  intents: [
    // 保留之前已经开启的其他意图（比如Guilds、GuildMessages等），新增下面这行
    GatewayIntentBits.GuildMembers,
  ]
});

// 如果使用discord.js v13及更早版本，意图写法如下
// const { Client, Intents } = require('discord.js');
// const client = new Client({
//   intents: [Intents.FLAGS.GUILDS, Intents.FLAGS.GUILD_MEMBERS, 其他你需要的意图]
// });

同时要前往Discord开发者后台，找到对应的机器人应用，在「Bot」页面下滑到Privileged Gateway Intents区域，打开Server Members Intent开关，否则意图不会生效。

第二步：修改代码主动拉取成员而非读缓存 #

不要直接读取本地缓存，改用guild.members.fetch()方法主动从Discord官方服务器拉取目标成员数据，修改后的完整代码如下：

get('/expired', '', async function (result) { // 函数前加async标记为异步
  let users = result.data.users;
  const guild = client.guilds.cache.get('842361027562831872');
  if (!guild) return; // 新增guild存在性判断，避免guild未加载时报错

  // 改用for of循环处理异步逻辑，避免forEach并发导致的异常
  for (const user of users) {
    let role = guild.roles.cache.find(role => role.name === user.role);
    if (!role) continue; // 用continue跳过当前无效角色，不要用return，否则会直接终止所有用户处理
    
    try {
      // 主动拉取成员数据，不走本地缓存
      const member = await guild.members.fetch(user.user);
      await member.roles.remove(role);
    } catch (err) {
      // 新增错误捕获，遇到用户不在服务器、机器人权限不足等异常时不会卡死整个流程
      console.log(`处理用户ID ${user.user} 失败：`, err);
    }
  }
});

额外注意项 #

• 确保你的机器人在对应服务器拥有管理角色（Manage Roles）权限，且机器人自身的角色排序要高于你需要移除的目标角色，否则会移除失败。
• 可以先打印user.user字段，确认输出是有效的字符串格式用户ID，排除接口返回数据格式问题。

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