Discord音乐机器人接入后仅播放几秒即停止问题排查

常见原因及对应解决方案 #

1. 音频流对象被垃圾回收 #

如果使用discord.py/nextcord等库，播放音频的FFmpegPCMAudio实例若未被持久引用，会被Python垃圾回收器销毁，导致播放中断。

• 解决：将音频流对象存储到全局变量或机器人实例属性中，保留引用：

  # 机器人类中添加属性存储当前音频
  class MusicBot(commands.Bot):
      def __init__(self):
          super().__init__(command_prefix='!')
          self.active_audio = None
  
  # 播放命令中保存引用
  @bot.command()
  async def play(ctx, url):
      vc = await ctx.author.voice.channel.connect()
      bot.active_audio = discord.FFmpegPCMAudio(url)
      vc.play(bot.active_audio)
  

2. FFmpeg参数配置错误 #

缺少关键参数（如-re控制流速率）会导致Discord服务器拒绝音频流，触发中断。

• 解决：添加正确的FFmpeg参数，确保流速率匹配Discord要求：

  audio_source = discord.FFmpegPCMAudio(url, options='-re -vn')
  

  同时检查FFmpeg是否为最新版本，路径配置正确（若系统未全局配置，需指定executable参数）。

3. 语音连接心跳中断 #

机器人语音客户端未保持活跃心跳，Discord服务器会主动断开连接。

• 解决：连接语音频道时启用自动重连，并避免阻塞事件循环：

  vc = await voice_channel.connect(reconnect=True)
  

  所有音频处理操作尽量使用异步方法，不要在主线程执行耗时任务。

4. 音频源本身问题 #

音频文件损坏、流媒体链接失效（如YouTube反爬限制）会导致播放中断。

• 解决：
  • 先用本地音频文件测试，排除源文件问题。
  • 若为YouTube链接，使用pytube或yt-dlp获取合法音频流URL，不要直接使用网页链接。

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