@discordjs/voice中connection.destroy()仅生效一次的修复方案

退出语音频道功能仅生效一次的核心原因是代码逻辑顺序错误，你把加入语音频道的逻辑写在了退出指令的执行流中：

• 每次触发退出指令时，代码都会先调用joinVoiceChannel()尝试创建新连接加入频道，再执行destroy()销毁连接。第一次执行时连接初始化流程正常，销毁操作可以成功触发退出
• 后续触发指令时，新创建的连接还未完成和Discord网关的信令握手就被调用销毁方法，不会实际发送退出频道的请求，同时残留的半连接状态会阻塞后续所有语音相关操作
• 没有按服务器维度缓存已存在的有效连接，无法精准定位当前机器人真实在用的连接实例，销毁操作经常作用于无效的临时实例

你需要按服务器（Guild）维度全局缓存语音连接实例，严格区分加入频道、退出频道的逻辑，不要在退出流程中调用加入频道的方法，参考实现如下：

1. 在全局作用域初始化依赖和连接缓存

const { joinVoiceChannel, getVoiceConnection, VoiceConnectionStatus } = require('@discordjs/voice');
// 全局缓存Map：key为服务器ID(guildId)，value为对应服务器的有效语音连接实例
const voiceConnections = new Map();

2. 仅在需要机器人加入语音频道的场景（比如播放音乐、接收入群语音通知的指令）中调用加入逻辑，同时将连接实例写入缓存

// 加入语音频道逻辑示例
const targetChannel = message.member.voice.channel;
if (!targetChannel) return message.reply('请先进入一个语音频道');
const connection = joinVoiceChannel({
  channelId: targetChannel.id,
  guildId: message.member.guild.id,
  adapterCreator: message.member.guild.voiceAdapterCreator,
});
// 将有效连接存入缓存
voiceConnections.set(message.member.guild.id, connection);
// 监听连接销毁事件，自动清理缓存避免脏数据
connection.on(VoiceConnectionStatus.Destroyed, () => {
  voiceConnections.delete(message.member.guild.id);
});

3. 退出频道逻辑中，直接获取已存在的有效连接执行销毁，不要重复创建连接

// 退出语音频道指令逻辑
const guildId = message.member.guild.id;
// 优先使用官方提供的方法获取现有连接，兼容自动重连等场景
const existingConnection = getVoiceConnection(guildId) || voiceConnections.get(guildId);
if (!existingConnection) {
  return message.reply('机器人当前未在任何语音频道中');
}
// 执行销毁，完成退出
existingConnection.destroy();
message.reply('已成功退出语音频道');

• joinVoiceChannel()的作用是创建连接加入语音频道，绝对不能出现在退出频道的逻辑中
• 不要自行维护复杂的连接状态，优先使用@discordjs/voice自带的getVoiceConnection()方法获取现有连接，兼容性更好
• 执行销毁操作前必须校验连接实例是否存在，避免空值报错
• 如果开启了自动重连配置，销毁前可以先调用existingConnection.removeAllListeners()移除所有监听，避免重连逻辑被意外触发

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