discord.js clear命令异常：无用户提及时删100条，带提及功能正常

异常触发原因 #

• 无用户分支的截断逻辑缺失：现有代码仅在user存在的判断分支内，对抓取到的100条历史消息做了目标用户过滤和指定删除数量的截取；执行不带用户提及的>clear 1指令时，抓取到的100条消息未做任何长度截断，直接传入删除接口
• 错位的重复删除调用：在分支判断逻辑外，代码硬编码了两次独立的批量删除执行：
  • 第一次硬提取首位参数计算删除量，额外执行一次多余删除
  • 第二次直接引用未截断的消息集合执行删除，最终触发无提及场景下删除100条消息的异常
• 作用域变量未定义风险：代码中引用的Client对象未在当前回调作用域完成声明，运行到对应过滤分支时会触发引用错误

修复后可用代码 #

module.exports = {
  commands: 'clear',
  permissionError: "you can't use that! :CattoBONK:",
  callback: async (message, args) => {
    // 抓取频道近100条历史消息，受Discord接口单次抓取上限限制
    const fetchedMessages = await message.channel.messages.fetch({ limit: 100 });
    const targetUser = message.mentions.users.first();
    let deleteAmount;

    // 按参数位置解析删除数量，避免解析提及字符串时出现数字误判
    if (targetUser) {
      deleteAmount = parseInt(args[1]);
    } else {
      deleteAmount = parseInt(args[0]);
    }

    // 边界值校验：仅支持删除1-100条消息
    if (isNaN(deleteAmount) || deleteAmount < 1 || deleteAmount > 100) {
      return message.reply('请指定1-100范围内的有效删除数量');
    }

    // 按场景筛选待删除消息
    let messagesToDelete;
    if (targetUser) {
      // 带用户提及：仅筛选目标用户发送的消息，按指定数量截取
      messagesToDelete = fetchedMessages.filter(msg => msg.author.id === targetUser.id).array().slice(0, deleteAmount);
    } else {
      // 不带用户提及：直接按指定数量截取抓取到的消息
      messagesToDelete = fetchedMessages.array().slice(0, deleteAmount);
    }

    // 执行批量删除，自动跳过超14天的过期消息
    await message.channel.bulkDelete(messagesToDelete, true);
    // 执行提示自动销毁，避免占用频道消息
    const tip = await message.channel.send(`已清理${messagesToDelete.length}条消息`);
    setTimeout(() => tip.delete(), 3000);
  },
  permissions: 'MANAGE_MESSAGES',
}

修复逻辑说明 #

• 统一了不同场景下的消息筛选截断逻辑，不再区分场景单独处理删除集合
• 删除了错位的冗余批量删除调用，仅保留一次统一的删除执行
• 替换了原消息字符串拆分的参数解析逻辑，基于用户提及的存在状态定位参数位置，避免@提及带数字导致的参数解析错误
• 增加了删除数量的边界值校验，适配Discord bulkDelete 接口1-100条的调用限制

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