Discord.js v12 昵称修改命令角色权限问题排查与修复求助

我明白你遇到的困扰了——当目标用户持有「Staff」这类层级高于机器人的角色时，命令会错误地返回“修改成功”，但控制台却抛出报错。这是因为你的权限检查逻辑存在漏洞，而且缺少必要的错误处理。下面一步步帮你修复：

问题根源 #

1. 无效的机器人角色层级检查：!message.guild.me.roles.highest.position这个判断完全没有意义，只要机器人在服务器中，它的最高角色必然有层级值，这个条件永远不会触发。你需要直接对比机器人与目标用户的最高角色层级。
2. 提示与执行顺序颠倒：你先发送了“修改成功”的Embed，再执行昵称修改操作，导致即使修改失败，用户也会看到错误的成功提示。
3. 未捕获修改错误：setNickname是异步操作，可能因权限不足失败，但你没有处理Promise的异常状态，导致控制台抛出未捕获的错误。
4. 忽略服务器所有者：服务器所有者不受角色层级限制，机器人无法修改其昵称，需要单独判断。

修复后的完整代码 #

client.on('message', async message => { 
  if (message.content.toLowerCase().startsWith(prefix + "nick")) { 
    // 处理无参数的情况
    if (message.content.toLowerCase() === prefix + "nick") {
      return message.channel.send('Pls mention someone and do `.nick @user [your text]`');
    }

    // 检查发起命令的用户是否有权限
    if (!message.member.hasPermission("MANAGE_NICKNAMES")) {
      return message.channel.send("You do not have permission to do that since you're missing `manage_nicknames` perm");
    }

    // 检查机器人自身是否有修改昵称的权限
    if (!message.guild.me.hasPermission("MANAGE_NICKNAMES")) {
      return message.channel.send("I don't have the `manage_nicknames` permission to change nicknames!");
    }

    if (message.author.bot || !message.guild) return;

    // 解析参数与目标用户
    let args = message.content.slice(prefix.length).split(/ +/); 
    let mentionedUser = message.mentions.members.first() || message.guild.members.cache.get(args[1]);
    
    // 检查目标用户是否存在
    if (!mentionedUser) {
      return message.channel.send("Couldn't find that user!");
    }

    // 检查目标用户是管理员的情况
    if (mentionedUser.hasPermission("ADMINISTRATOR")) {
      return message.channel.send("I can't change this user nickname since he has `administrator` perm");
    }

    // 检查目标用户是服务器所有者
    if (mentionedUser.id === message.guild.ownerId) {
      return message.channel.send("I can't change the server owner's nickname!");
    }

    // 检查机器人角色层级是否低于目标用户
    if (mentionedUser.roles.highest.position >= message.guild.me.roles.highest.position) {
      return message.channel.send("I can't change that user's nickname since my highest role is lower than theirs!");
    }

    // 获取新昵称并校验
    let name = args.slice(2).join(" ");
    if (!name) {
      return message.channel.send("Please provide a new nickname!");
    }

    try {
      // 执行昵称修改操作
      await mentionedUser.setNickname(name);
      // 修改成功后再发送提示
      const successEmbed = new Discord.MessageEmbed()
        .setColor("RANDOM")
        .setDescription(`I have successfully changed **${mentionedUser.user.tag}** nickname to **${name}**.`)
        .setTimestamp();
      message.channel.send(successEmbed);
    } catch (error) {
      // 捕获错误并反馈给用户
      console.error("Failed to change nickname:", error);
      message.channel.send("Oops! Something went wrong while trying to change the nickname.");
    }
  } else if (message.content.toLowerCase() === prefix + "help nick") { 
    const helpEmbed = new Discord.MessageEmbed() 
      .setColor('#00B2B2') 
      .setTitle('**Nick Help**')
      .setDescription('This command changes users\' nicknames. Example: `.nick @user 123`.') 
      .setFooter(`Requested by ${message.author.tag}`, message.author.displayAvatarURL()) 
      .setTimestamp(); 
    message.channel.send(helpEmbed); 
  }
})

关键修改点说明 #

• 新增机器人权限检查：确保机器人本身拥有MANAGE_NICKNAMES权限，避免因自身权限不足导致的失败。
• 正确的角色层级对比：通过mentionedUser.roles.highest.position >= message.guild.me.roles.highest.position，准确判断机器人是否有权操作目标用户。
• 服务器所有者判断：单独处理服务器所有者的情况，符合Discord的权限规则。
• 错误捕获与顺序调整：用try/catch包裹修改操作，确保只有修改成功后才发送成功提示，失败则反馈给用户并打印错误日志。
• 完善参数校验：新增目标用户不存在、未提供新昵称的判断，避免后续逻辑报错。

这样修改后，当遇到角色层级更高的用户时，会提前返回错误提示，不会再出现“假成功”的情况，控制台也不会抛出未处理的错误了。

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