Discord.js v14音乐机器人play命令FFmpeg问题求助

问题梳理 #

你作为Web开发背景转Discord机器人开发，使用Discord.js v14编写单链接播放命令时遇到以下问题：

• 已安装FFmpeg且终端执行ffmpeg -version正常，但机器人启动仍报错Error: FFmpeg/avconv not found!
• 排查process.env.PATH后终端无报错，但歌曲无法正常播放

解决方案 #

1. 强制指定FFmpeg路径 #

@discordjs/voice可能无法自动识别系统中的FFmpeg路径，手动指定路径即可解决找不到的问题：

• 先确定FFmpeg可执行文件路径：Windows下通常是C:\ffmpeg\bin\ffmpeg.exe，Linux/macOS下为/usr/bin/ffmpeg；或直接使用ffmpeg-static包的内置路径
• 在代码中导入并设置路径：

const { joinVoiceChannel, createAudioPlayer, createAudioResource, setFFmpegPath } = require('@discordjs/voice');
const ffmpeg = require('ffmpeg-static'); // 先执行 npm install ffmpeg-static

// 使用ffmpeg-static内置路径，无需手动填写系统路径
setFFmpegPath(ffmpeg);

2. 修复ytdl-core流兼容性问题 #

ytdl-core直接输出的流可能存在编码不兼容问题，通过FFmpeg转码为opus格式可解决无声问题：

const ytdl = require('ytdl-core');
const { exec } = require('child_process');

// 替换原有的stream和resource创建逻辑
const stream = ytdl('URL_HERE', { filter: 'audioonly', quality: 'highestaudio' });
// 通过FFmpeg将流转为opus格式
const ffmpegProcess = exec(`${ffmpeg} -i - -f opus -`, { stdio: ['pipe', 'pipe', 'ignore'] });
stream.pipe(ffmpegProcess.stdin);
const resource = createAudioResource(ffmpegProcess.stdout, { inputType: 'opus' });

3. 添加播放器事件监听排查问题 #

通过监听播放器的错误和状态变化，可快速定位无声或报错的原因：

const player = createAudioPlayer();

// 监听错误事件
player.on('error', error => {
    console.error('播放器错误:', error);
    interaction.followUp(`播放出错：${error.message}`);
});

// 监听状态变化
player.on('stateChange', (oldState, newState) => {
    console.log(`播放器状态：${newState.status}`);
});

connection.subscribe(player);
player.play(resource);

4. 确认机器人权限配置 #

• 确保机器人角色拥有目标语音频道的Connect和Speak权限
• 检查服务器角色设置，避免权限不足导致无法播放

完整修改后的代码示例 #

const { joinVoiceChannel, createAudioPlayer, createAudioResource, setFFmpegPath } = require('@discordjs/voice');
const ytdl = require('ytdl-core');
const ffmpeg = require('ffmpeg-static');
const { exec } = require('child_process');

// 手动指定FFmpeg路径
setFFmpegPath(ffmpeg);

module.exports = {
    devOnly: true,
    name: 'play',
    description: '播放歌曲！',

    callback: async (client, interaction) => {
        const voiceChannel = interaction.member.voice.channel;

        if (!voiceChannel) {
            return interaction.reply('你必须加入语音频道才能使用此命令。');
        }

        const connection = joinVoiceChannel({
            channelId: voiceChannel.id,
            guildId: interaction.guild.id,
            adapterCreator: interaction.guild.voiceAdapterCreator,
        });

        try {
            const stream = ytdl('URL_HERE', { filter: 'audioonly', quality: 'highestaudio' });
            const ffmpegProcess = exec(`${ffmpeg} -i - -f opus -`, { stdio: ['pipe', 'pipe', 'ignore'] });
            stream.pipe(ffmpegProcess.stdin);
            const resource = createAudioResource(ffmpegProcess.stdout, { inputType: 'opus' });

            const player = createAudioPlayer();

            player.on('error', error => {
                console.error('播放器错误:', error);
                interaction.followUp(`播放出错：${error.message}`);
            });

            player.on('stateChange', (oldState, newState) => {
                console.log(`播放器状态：${newState.status}`);
            });

            connection.subscribe(player);
            player.play(resource);

            await interaction.reply({ content: `正在播放歌曲` });
        } catch (error) {
            console.error('命令执行错误:', error);
            await interaction.reply(`执行命令时出错：${error.message}`);
        }
    }
}

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