Discord.js v12：如何让机器人不尝试封禁角色高于自身的成员

核心逻辑 #

在执行封禁操作前，先对比目标成员与机器人的最高角色层级——Discord服务器中角色位置数值越高，权限优先级越高。如果目标成员的最高角色层级高于或等于机器人，直接终止操作并返回提示，避免触发权限报错。

完整代码实现 #

client.on('message', async message => {
  // 过滤非封禁指令及机器人消息
  if (!message.content.startsWith('!ban') || message.author.bot) return;

  // 获取被提及的目标成员
  const targetMember = message.mentions.members.first();
  if (!targetMember) {
    return message.reply('请明确指定要封禁的成员');
  }

  // 先检查机器人自身是否拥有封禁权限
  if (!message.guild.me.hasPermission('BAN_MEMBERS')) {
    return message.reply('我没有封禁成员的权限，请先给我配置对应权限');
  }

  // 关键：对比角色层级
  const botHighestRolePos = message.guild.me.roles.highest.position;
  const targetHighestRolePos = targetMember.roles.highest.position;

  if (targetHighestRolePos >= botHighestRolePos) {
    return message.reply('无法封禁角色层级高于或等于我的成员');
  }

  // 执行封禁，用try-catch处理其他潜在错误
  try {
    // 可自定义封禁理由
    await targetMember.ban({ reason: '违反服务器规则' });
    message.channel.send(`已成功封禁成员：${targetMember.user.tag}`);
  } catch (err) {
    console.error('封禁操作出错：', err);
    message.reply('封禁过程中出现异常，请检查目标成员是否为服务器所有者或我的权限配置');
  }
});

关键细节说明 #

• roles.highest.position：该属性返回角色在服务器角色列表中的位置数值，数值越大代表角色层级越高
• 对比条件用>=：如果目标成员和机器人的最高角色层级相同，机器人同样无法封禁对方
• 额外权限检查：提前验证机器人是否拥有BAN_MEMBERS权限，避免因基础权限不足报错
• try-catch捕获：即使做了层级检查，仍可能存在其他异常（比如目标是服务器所有者），用try-catch可以优雅处理并给出提示

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