Discord音乐Bot执行!play命令无响应问题求助

你的Discord音乐Bot执行!play无响应，核心问题及修复方案如下：

1. 事件监听错误（关键原因） #

Discord.js v13及以上版本已废弃message事件，改用messageCreate事件监听消息，旧事件不会触发，导致Bot完全接收不到!play指令。

2. 语音连接未处理Promise #

voice.channel.join()返回的是Promise对象，不能直接调用.play()，必须等待Promise完成后拿到真实连接对象。

3. Intents权限不全 #

你设置的intents值7796缺少必要权限，必须包含GUILD_VOICE_STATES、GUILD_MESSAGES、MESSAGE_CONTENT，否则Bot无法读取消息、获取语音频道状态。

4. 缺少错误处理逻辑 #

未对链接有效性、连接失败、播放错误做捕获，出问题时无日志提示，难以排查问题。

修复后的完整代码 #

const Discord = require('discord.js');
const ytdl = require('ytdl-core');
const token = '你的Bot令牌';

// 配置完整的必要Intents
const client = new Discord.Client({
  intents: [
    Discord.GatewayIntentBits.Guilds,
    Discord.GatewayIntentBits.GuildMessages,
    Discord.GatewayIntentBits.MessageContent,
    Discord.GatewayIntentBits.GuildVoiceStates
  ]
});

client.on('ready', () => {
  console.log(`已登录为 ${client.user.tag}!`);
});

// 使用正确的messageCreate事件监听消息
client.on('messageCreate', async message => {
  if (message.content.startsWith('!play')) {
    const args = message.content.split(' ');
    // 检查是否提供YouTube链接
    if (!args[1]) {
      return message.reply('请提供有效的YouTube链接！');
    }
    const youtubeLink = args[1];

    // 验证链接有效性
    if (!ytdl.validateURL(youtubeLink)) {
      return message.reply('这不是有效的YouTube链接！');
    }

    // 检查用户是否在语音频道
    if (!message.member.voice.channel) {
      return message.reply('你需要先加入一个语音频道！');
    }

    try {
      // 等待语音频道连接完成
      const connection = await message.member.voice.channel.join();
      
      // 创建音频流
      const stream = ytdl(youtubeLink, { 
        filter: 'audioonly',
        quality: 'highestaudio'
      });
      
      // 播放音频
      const dispatcher = connection.play(stream);

      dispatcher.on('start', () => {
        console.log('正在播放音频...');
        message.reply(`开始播放：${youtubeLink}`);
      });

      dispatcher.on('finish', () => {
        console.log('音频播放完毕');
        connection.disconnect();
      });

      // 捕获播放错误
      dispatcher.on('error', error => {
        console.error('播放错误:', error);
        message.reply('播放音频时发生错误，请检查链接或重试！');
        connection.disconnect();
      });
    } catch (error) {
      console.error('连接语音频道失败:', error);
      message.reply('无法加入语音频道，请检查Bot权限！');
    }
  }
});

client.login(token);

额外注意事项 #

• 前往Discord开发者平台，在Bot设置的Privileged Gateway Intents中开启MESSAGE CONTENT INTENT权限。
• 确保依赖为最新版本：执行npm install discord.js ytdl-core更新。
• 给Bot分配服务器权限：Connect、Speak、View Channels。

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