Discord.js Commando命令触发随机发消息机器人无响应问题排查

核心故障原因 #

• 代码中使用的同步while(true)死循环会完全阻塞Node.js的单线程事件循环。JS执行同步代码时不会切分线程处理网络请求、消息收发等异步任务，这会导致循环启动后，连最开始的"Scanning...."提示消息都无法正常发送，整个机器人进程卡死，自然没有任何响应也不会抛出错误。
• 原代码没有任何运行状态控制逻辑，就算循环能正常运行，也没有办法触发停止指令，最终会因为无限制调用Discord API触发速率限制，导致机器人被封禁。
• Commando框架版本迭代后，Message对象不再内置.say()快捷方法，直接调用会触发方法不存在的错误（之前没报错是因为进程被死循环堵死，根本没走到方法调用的环节）。

分步修复实现 #

1. 改造循环为异步可中断结构
   移除纯同步死循环，给循环增加状态标记，搭配延时实现非阻塞的轮询逻辑，全程不会卡住事件循环。
2. 增加消息间隔控制
   每次消息发送后增加20-40秒的随机延时，避免触发Discord的API速率限制。
3. 实现停止指令逻辑
   用内存Map存储各频道的雷达功能运行状态，收到停止指令时修改对应状态，循环自动退出。
4. 修正消息发送方法
   统一使用Commando兼容的message.channel.send()方法发送消息，避免方法不存在的报错。

参考可运行代码 #

首先初始化机器人的时候，给客户端绑定状态存储对象：

// 客户端初始化时增加状态存储，记录每个频道的雷达运行状态
client.radarState = new Map();

雷达触发命令的核心run方法：

async run(message) {
  // 先判断当前频道是否已经在运行雷达，避免重复触发
  if (client.radarState.get(message.channel.id)) {
    return message.channel.send("当前频道已经在执行雷达扫描");
  }

  // 标记当前频道为运行状态
  client.radarState.set(message.channel.id, true);
  await message.channel.send("Scanning....");

  // 异步循环，不会阻塞事件循环
  while (client.radarState.get(message.channel.id)) {
    // 生成1-30的随机数，替换原有冗余的随机数计算逻辑
    const imageNumber = Math.floor(Math.random() * 30) + 1;
    
    if (imageNumber === 1) {
      await message.channel.send("^ detected!");
    }

    // 随机等待20-40秒，避免触发API限流
    await new Promise(resolve => {
      setTimeout(resolve, Math.floor(Math.random() * 20000) + 20000);
    });
  }
}

配套的停止命令逻辑（可单独写一个命令类）：

async run(message) {
  // 判断当前频道是否在运行雷达
  if (!client.radarState.get(message.channel.id)) {
    return message.channel.send("当前频道没有运行中的雷达扫描");
  }

  // 删除状态标记，循环会自动退出
  client.radarState.delete(message.channel.id);
  await message.channel.send("雷达扫描已停止");
}

注意事项 #

• 循环内的所有异步操作（包括发消息、延时）必须加await，否则还是会回到同步阻塞事件循环的问题。
• 消息发送间隔不要低于10秒，过短的高频发送会被Discord判定为垃圾消息，导致机器人被平台封禁。
• 内存存储的状态会在机器人重启后丢失，如果需要持久化保存运行状态，可以将状态写入本地JSON文件，机器人启动时读取恢复。

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