Discord.js机器人实现VC离开指令时的三类运行异常修复求助

• 原代码未对机器人自身语音连接状态做前置空值校验，当机器人未连接任何VC时，client.voice.channel为undefined，代码直接读取其id属性就会抛出TypeError，且因未做Promise错误捕获，最终出现控制台报错、用户侧无响应的问题。
• 同频道场景下重复发送两类提示的原因：异步的leave()操作未加await，机器人断开连接的状态会异步更新，导致同频道判断分支在状态变更后误触发频道不匹配的错误提示；同时原代码直接使用全局的client.voice.channel 获取连接状态，在多服务器部署场景下容易出现频道信息串线，判断逻辑失准。
• 用户不在VC、机器人在线的场景下返回错误提示的原因：判断逻辑没有先校验机器人的连接状态，读取不存在的频道对象时直接跳过了用户未入VC的正确分支，触发了频道不匹配的错误提示。

按照判断优先级梳理完整分支，全程做空值兜底、异步操作加错误捕获，分支优先级为：

1. 校验指令发起人是否在语音频道内，不在则返回对应提示
2. 校验当前服务器内机器人的语音连接状态，未连接则返回对应提示
3. 校验双方是否处于同一语音频道，不匹配则返回对应提示
4. 所有校验通过后执行断开操作，返回成功提示

client.on('messageCreate', async (message) => {
  // 过滤机器人消息和非指令开头的消息
  if (message.author.bot || !message.content.startsWith(prefix)) return;

  const args = message.content.slice(prefix.length).trim().split(/ +/);
  const command = args.shift().toLowerCase();

  if (command === 'leave') {
    // 校验指令发起人语音状态
    const authorVoiceChannel = message.member?.voice?.channel;
    const notInVCEmbed = new discord.MessageEmbed()
      .setTitle('🚫 `You are not in a Voice Channel!`')
      .setColor('RED')
      .setTimestamp();
    if (!authorVoiceChannel) {
      return message.channel.send({ embeds: [notInVCEmbed] });
    }

    // 校验当前服务器内机器人的语音连接状态
    const botVoiceChannel = message.guild?.members?.me?.voice?.channel;
    const botNotConnectedEmbed = new discord.MessageEmbed()
      .setTitle('🚫 `I am not connected to any Voice Channel!`')
      .setColor('RED')
      .setTimestamp();
    if (!botVoiceChannel) {
      return message.channel.send({ embeds: [botNotConnectedEmbed] });
    }

    // 校验双方是否在同一语音频道
    const notSameChannelEmbed = new discord.MessageEmbed()
      .setTitle('⛔ `We are not in the same Voice Channel`')
      .setColor('YELLOW')
      .setTimestamp();
    if (authorVoiceChannel.id !== botVoiceChannel.id) {
      return message.channel.send({ embeds: [notSameChannelEmbed] });
    }

    // 执行断开操作并返回结果
    const leaveSuccessEmbed = new discord.MessageEmbed()
      .setTitle('`Successfully left the Voice Channel` ✔')
      .setColor('GREEN')
      .setTimestamp();
    try {
      await botVoiceChannel.leave();
      await message.channel.send({ embeds: [leaveSuccessEmbed] });
    } catch (err) {
      console.error('断开语音频道失败:', err);
      await message.channel.send({ content: '❌ 断开语音频道时出现错误，请稍后重试' });
    }
  }
});

• 所有语音状态读取均使用可选链?.做兜底空值判断，从根源上避免读取undefined属性的类型错误
• 替换了旧版全局的client.voice.channel获取方式，改为从当前指令所在服务器的机器人成员对象中读取连接状态，解决多服务器部署时的频道判断串线问题
• 调整了分支判断顺序，覆盖所有用户场景：
  • 双方同频道时仅返回成功离开的提示，无重复错误响应
  • 用户不在VC时仅返回“你未连接VC”的提示，不会错误触发频道不匹配的报错
  • 双方都未连接VC时返回对应提示，无控制台报错、无响应的问题
• 所有异步操作（发送消息、断开VC）均添加了await和try/catch错误捕获，避免未处理的Promise rejection
• 消息发送格式适配Discord.js v14+规范，避免旧版接口的弃用警告

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