Discord音乐bot传参后仍提示缺第二参数、无法连VC播放音乐

问题1：传入参数仍提示缺少第二参数 #

• 核心原因不在你贴的这段play命令逻辑里，出在前置的命令解析逻辑：你处理消息切割命令前缀、拆分参数的代码有bug，大概率是没处理命令后多空格、前缀匹配规则写得太死，导致传入execute方法的args数组始终为空。你可以在if (!args.length)这行前加console.log('收到的参数：', args)，执行命令时看控制台输出，就能直接确认参数是否正常传入。
• 额外问题：你写的URL校验正则匹配范围过宽，会把所有带http开头的链接都判定为有效YouTube链接，后续调用ytdl拉流时会直接报错。

问题2：无法接入语音频道 #

• 如果你用的是discord.js v12及以上版本，原生的voiceChannel.join()API已经被废弃，语音能力被拆分为独立的@discordjs/voice依赖包，旧API调用后无法正常建立语音连接。
• 你没有给语音连接逻辑加异常捕获，遇到频道满员、权限临时失效、网络波动的情况，代码会直接抛出未处理异常中断执行，不会返回任何提示。
• 小问题：权限报错提示里的permissins单词拼写错误，不影响逻辑但提示文案不准确。

问题3：无法播放音乐 #

• ytdl-core默认拉取的音频流参数和Discord语音播放要求不兼容，你没配置highWaterMark缓存参数，大概率会出现流加载失败、播放无声、播放几秒就断的问题。另外connection.play方法里的volume参数在新版discord.js中已经被废弃，传入后可能触发兼容错误。
• 代码冗余：你在URL分支和搜索分支重复写了两次const connection = await voiceChannel.join()，每次执行命令都会重复发起语音连接，容易触发连接互斥导致播放失败。
• 缺少异常监听：你没有给音频流、播放器绑定error事件监听，遇到视频有年龄限制、地域限制、被下架的情况，代码会直接崩溃，不会给用户返回错误提示。

修正参考（核心逻辑片段） #

// 先安装对应依赖：npm i @discordjs/voice @discordjs/opus ffmpeg-static
const { joinVoiceChannel, createAudioPlayer, createAudioResource, AudioPlayerStatus } = require('@discordjs/voice');
const ytdl = require('ytdl-core');
const ytSearch = require('yt-search');

module.exports = {
name: 'play',
description: 'Joins and plays a video from youtube',
async execute(message, args) {
const voiceChannel = message.member.voice.channel;

    if (!voiceChannel) return message.channel.send('你需要先进入语音频道才能执行这个命令！'); 
    const permissions = voiceChannel.permissionsFor(message.client.user);
    if (!permissions.has('CONNECT')) return message.channel.send('机器人缺少语音频道连接权限');
    if (!permissions.has('SPEAK')) return message.channel.send('机器人缺少语音频道发言权限');
    // 加日志排查参数问题
    console.log('play命令收到参数：', args);
    if (!args.length) return message.channel.send('你需要传入要播放的歌曲名称或YouTube链接！');

    const validURL = (str) =>{
        // 修正正则，只匹配YouTube链接
        var regex = /^(https?:\/\/)?(www\.)?(m\.)?(youtube\.com|youtu\.?be)\/.+$/;
        return regex.test(str);
    }

    // 统一建立语音连接，不要重复写join逻辑
    const connection = joinVoiceChannel({
        channelId: voiceChannel.id,
        guildId: message.guild.id,
        adapterCreator: message.guild.voiceAdapterCreator,
    });
    const player = createAudioPlayer();
    connection.subscribe(player);

    // 统一播放逻辑封装
    const playStream = (url) => {
        const stream = ytdl(url, {
            filter: 'audioonly',
            highWaterMark: 1<<25,
            dlChunkSize: 0
        });
        const resource = createAudioResource(stream);
        player.play(resource);
        player.on(AudioPlayerStatus.Idle, () => {
            connection.destroy();
            message.channel.send('播放结束，离开语音频道');
        });
        // 加错误监听
        player.on('error', err => {
            console.error('播放出错：', err);
            message.channel.send('播放时出现错误');
            connection.destroy();
        })
    }

    if(validURL(args[0])){
        playStream(args[0]);
        await message.reply(`:thumbsup: 正在播放你传入的链接内容`)
        return
    }

    const videoFinder = async (query) => {
        const videoResult = await ytSearch(query);
        return (videoResult.videos.length >= 1) ? videoResult.videos[0] : null;
    }

    const video = await videoFinder(args.join(' '));

    if(video){
        playStream(video.url);
        await message.reply(`:thumbsup: 正在播放 ***${video.title}***`)
    } else {
        message.channel.send('没有找到匹配的视频结果');
    }
}
}

注意：如果改完还是提示缺参数，直接去检查你的命令解析逻辑（也就是message事件里切割prefix、拆分args的部分），这部分逻辑你没贴出来，但100%是这里的问题导致args传空。

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