Discord.js 移除所有成员指定角色时报错message not defined如何解决

message变量未定义的核心原因是你当前执行的代码不在Discord.js消息事件的回调上下文内，只有当你在监听消息创建事件、且回调参数声明了message时，这个变量才能正常调用。

根据不同使用场景提供对应修复方案：

场景1：通过发送指令触发移除角色操作 #

这是最常用的场景，比如你发送指定指令后机器人执行移除操作，完整代码示例如下：

// 需先开启必要的网关意图，否则无法获取对应数据
const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
    GatewayIntentBits.GuildMembers // 必须开启该意图才能获取服务器成员列表
  ]
});

client.on('messageCreate', async message => {
  // 这里判断指令触发条件，且校验发送者有管理角色权限
  if (message.content === '!移除指定角色' && message.member.permissions.has('ManageRoles')) {
    const targetRoleId = '12345678901234'; // 替换为你要移除的角色ID
    // 先筛选持有目标角色的成员再操作，比遍历所有成员效率更高
    const targetMembers = message.guild.members.cache.filter(member => member.roles.cache.has(targetRoleId));
    // 遍历移除时添加错误捕获，避免单个成员移除失败阻塞全流程
    targetMembers.forEach(async member => {
      try {
        await member.roles.remove(targetRoleId);
      } catch (err) {
        console.log(`移除成员 ${member.user.tag} 角色失败:`, err);
      }
    });
    await message.reply(`已完成所有持有该角色成员的角色移除操作`);
  }
});

client.login('你的机器人令牌');

场景2：机器人启动后自动执行移除操作 #

如果不需要通过消息触发，机器人就绪后直接执行操作的话，可以不依赖message对象，直接从客户端实例获取对应服务器即可：

client.on('ready', async () => {
  console.log(`机器人已登录为 ${client.user.tag}`);
  const targetGuildId = '你的服务器ID'; // 替换为你的服务器ID
  const targetRoleId = '12345678901234'; // 替换为你要移除的角色ID
  const guild = await client.guilds.fetch(targetGuildId);
  // 拉取全量成员，避免缓存不全导致漏操作
  const allMembers = await guild.members.fetch();
  const targetMembers = allMembers.filter(member => member.roles.cache.has(targetRoleId));
  targetMembers.forEach(async member => {
    try {
      await member.roles.remove(targetRoleId);
    } catch (err) {
      console.log(`移除成员 ${member.user.tag} 角色失败:`, err);
    }
  });
  console.log('角色移除操作执行完成');
});

• 必须给机器人授予ManageRoles权限，且机器人的角色排序要高于你要移除的目标角色，否则会移除失败
• Discord.js v14及以上版本必须显式声明对应的网关意图，否则无法正常获取成员、消息等数据
• 建议先筛选持有目标角色的成员再执行移除，不要直接遍历所有服务器成员，可大幅提升执行效率

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