如何修复Discord音乐机器人的TypeError: Cannot read properties of null (reading 'on')

报错原因 #

TypeError: Cannot read properties of null (reading 'on') 报错的核心是**queue.connection的值为null**，导致无法调用on方法绑定disconnect事件。这意味着机器人尝试播放音乐时，并未成功建立与语音频道的连接，或者连接已意外丢失。

可能的触发场景包括：

• 机器人被强制踢出语音频道
• 目标语音频道被解散或不可用
• 网络波动导致连接建立失败
• 队列初始化时未正确将连接实例赋值给queue.connection

修复方案 #

1. 增加空值判断，避免直接调用null的方法 #

修改报错行的代码，先检查queue.connection是否存在，再绑定事件：

// 替换原报错行
if (queue.connection) {
  queue.connection.on("disconnect", () => message.client.queue.delete(message.guild.id));
} else {
  // 可选：处理连接不存在的情况，比如清理队列并提示用户
  message.client.queue.delete(message.guild.id);
  attentionembed(message, "语音连接失败，已清理播放队列");
}

2. 排查连接建立逻辑 #

检查机器人加入语音频道的相关代码，确保：

• 机器人拥有连接语音频道和语音活动的权限
• 目标语音频道处于正常可用状态（未被删除、未设置权限限制）
• 连接建立后，正确将连接对象赋值给queue.connection，没有被后续代码意外覆盖或置空

3. 优化播放前的状态检查 #

在play方法的开头增加前置检查，提前拦截无效状态：

// 在play方法开头添加
if (!queue || !queue.connection) {
  return attentionembed(message, "当前无有效播放队列或语音连接");
}

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