You need to enable JavaScript to run this app. Discord.js结合Quick.db开发多服务器兼容Highlight命令问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Discord.js结合Quick.db开发多服务器兼容Highlight命令问题求助

Highlight 指令 Bug 修正与多服通用实现方案

原代码存在的核心问题

  • 变量作用域拼写错误:权限校验分支内定义的嵌入对象为a,发送时错误引用未定义的b对象,会直接触发ReferenceError导致指令失效
  • 数据存储结构不合理:原逻辑以bl_服务器ID、ms_服务器ID为键存储,同一服务器下所有规则共用一套接收人列表,后设置规则的用户ID会覆盖之前的用户ID,完全不支持多用户、多规则共存
  • 数组遍历逻辑缺陷:首次添加单个关键词时,数据库返回的是字符串而非数组,此时用for...in遍历会逐字符匹配关键词,触发完全错误的匹配结果
  • 消息监听边界缺失:未过滤机器人消息、自身发送的消息、服务器外的私信消息,遇到message.guild为null的场景会直接报错
  • 错误捕获缺失:调用client.users.cache.get(ms).send(ee)时未处理用户关闭私信、用户不在缓存内的异常,会触发未捕获的Promise rejection导致客户端崩溃
  • 废弃API兼容问题:代码使用的旧版message事件、message.member.hasPermission方法在Discord.js v13以上版本已被移除,直接运行会报错

修正后可运行的完整实现代码

// 指令执行分支
if (command === "highlight") {
  // 权限校验(适配v14权限枚举)
  if (!message.member.permissions.has(Discord.PermissionFlagsBits.Administrator)) {
    const color = message.member.displayHexColor ?? "RANDOM";
    const permEmbed = new Discord.MessageEmbed()
      .setTitle(`Uh oh ${message.author.tag}`)
      .setDescription(`你需要"管理员"权限才能使用该指令`)
      .setColor(color);
    // 修正原代码的变量引用错误
    return message.channel.send(permEmbed);
  }

  if (!args[0]) {
    const color = message.member.displayHexColor ?? "RANDOM";
    const argEmbed = new Discord.MessageEmbed()
      .setTitle(`${message.author.tag}`)
      .setDescription(`请输入你要设置的高亮关键词`)
      .setColor(color);
    return message.channel.send(argEmbed);
  }

  // 重构存储结构:每个服务器的规则以对象数组存储,绑定关键词和设置规则的用户ID
  const ruleKey = `highlight_rules_${message.guild.id}`;
  const existingRules = db.get(ruleKey) ?? [];
  // 避免重复添加相同关键词
  const keyword = args[0].toLowerCase();
  const isRuleExist = existingRules.some(rule => rule.keyword === keyword);
  if (isRuleExist) {
    return message.channel.send("该关键词的高亮规则已存在");
  }
  // 推入新规则
  existingRules.push({
    keyword: keyword,
    userId: message.author.id
  });
  db.set(ruleKey, existingRules);

  const color = message.member.displayHexColor ?? "RANDOM";
  const successEmbed = new Discord.MessageEmbed()
    .setTitle("高亮规则添加成功")
    .setColor(color);
  message.channel.send(successEmbed);
}

// 消息监听分支(替换废弃的message事件为v14标准的messageCreate)
client.on("messageCreate", async message => {
  // 边界拦截:忽略私信、机器人消息、自己发的消息
  if (!message.guild || message.author.bot || message.author.id === client.user.id) return;
  
  const ruleKey = `highlight_rules_${message.guild.id}`;
  const rules = db.get(ruleKey) ?? [];
  if (rules.length === 0) return;

  const messageContent = message.content.toLowerCase();
  // 遍历所有规则,收集匹配到的规则对应用户
  const matchedUserIds = new Set();
  for (const rule of rules) {
    if (messageContent.includes(rule.keyword)) {
      matchedUserIds.add(rule.userId);
    }
  }
  if (matchedUserIds.size === 0) return;

  // 构造通用通知Embed
  const notifyEmbed = new Discord.MessageEmbed()
    .setTitle(`你关注的关键词被提及`)
    .setDescription(`消息内容:${message.content}`)
    .setURL(message.url)
    .addField("所在服务器", message.guild.name)
    .addField("消息发送者", message.author.tag)
    .setColor("YELLOW");

  // 逐个给匹配到的用户发私信,增加异常捕获
  for (const userId of matchedUserIds) {
    try {
      // 主动拉取用户信息,避免缓存缺失报错
      const targetUser = await client.users.fetch(userId);
      await targetUser.send({ embeds: [notifyEmbed] });
    } catch (err) {
      console.log(`用户${userId}关闭了私信,无法发送高亮通知`);
    }
  }
});

实现效果说明

  • 数据库键完全按服务器ID隔离,支持多服务器之间的规则完全独立互不干扰
  • 同一服务器下支持不同用户设置各自的高亮规则,规则之间互相独立,不会出现用户ID被覆盖的问题
  • 增加了重复规则校验,避免相同关键词重复存储
  • 增加了异常捕获,不会因为用户关闭私信、用户不在缓存中导致客户端崩溃
  • 同一条消息匹配多个关键词时,会去重后只给对应用户发送一次通知,不会重复触发私信

内容的提问来源于stack exchange,提问作者LinusDropTips

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 10:45:04