问题详情 #

• 运行环境：Windows 10，基于Discord.py开发音乐功能Cog
• 异常现象：机器人可正常加入语音频道，但无任何音频输出且无报错信息；now命令显示队列已取出目标歌曲，但任务管理器中未发现FFmpeg相关进程
• 问题定位范围：FFmpeg调用逻辑、歌曲队列管理或音频源创建环节（涉及audio_player_task、create_source、play、play_next_song等核心代码段）

已尝试的解决方案 #

• 确认音乐Cog已成功加载
• 重装ffmpeg、pynacl、yt_dlp依赖包
• 将ffmpeg.exe添加至系统环境变量PATH
• 验证summon等其他语音频道相关命令可正常执行
• 确认所有依赖包版本兼容且完整
• 基于Discord.py官方文档编写极简语音播放机器人，仍无法播放音频
• 将ffmpeg.exe放置在Bot程序的同一目录下
• 使用print语句调试关键流程的变量与执行状态

当前排查线索 #

改用FFmpegOpusAudio实现的极简播放器可正常输出音频，但原Cog中基于FFmpegPCMAudio的处理与播放逻辑存在问题，希望在保留原Cog丰富功能的前提下修复音频播放异常。

修复建议 #

1. 检查FFmpegPCMAudio的参数配置

   • 显式指定FFmpeg可执行文件路径，避免PATH解析问题：

     source = discord.FFmpegPCMAudio(song_url, executable="C:/path/to/ffmpeg.exe")
     

   • 添加FFmpeg日志参数，捕获命令执行细节：

     source = discord.FFmpegPCMAudio(
         song_url,
         executable="ffmpeg.exe",
         before_options="-loglevel debug -report"
     )
     

     执行后会生成FFmpeg日志文件，可排查命令是否正常启动、是否存在输入源错误。

2. 验证音频源的生命周期与播放回调

   • 确保audio_player_task中持续持有音频源对象，避免被Python垃圾回收机制提前销毁
   • 检查voice_client.play()调用时是否正确传入after回调函数，确保播放结束后能触发下一首歌曲加载：

     def after_playing(error):
         if error:
             print(f"播放出错: {error}")
         self.play_next_song(ctx)
     
     voice_client.play(source, after=after_playing)
     

3. 适配FFmpegOpusAudio替代原PCM逻辑

   • FFmpegPCMAudio输出PCM格式需Discord.py内部转码为Opus，而FFmpegOpusAudio直接输出Opus格式，可尝试将原Cog的音频源替换为FFmpegOpusAudio并保留原有功能参数：

     source = discord.FFmpegOpusAudio(
         song_url,
         executable="ffmpeg.exe",
         options="-vn -filter:a 'volume=0.5'"  # 保留原有的滤镜、音量调节等参数
     )
     

4. 排查队列与任务调度逻辑

   • 确认play_next_song函数中正确从队列取出下一首歌曲，且创建音频源的逻辑无异常
   • 检查audio_player_task是否在后台持续运行，未被异常终止或阻塞

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