Discord音乐机器人报错：VoiceClient.play()缺失source参数求助

1. 修复VoiceClient.play()缺少source参数的报错 #

这个错误的直接原因是调用VoiceClient.play()时未传入必填的source参数，或者传参顺序错误。按以下步骤修正：

• 规范调用语法：必须将AudioSource实例作为第一个参数传入play()，示例：

  # 正确写法
  audio_source = discord.FFmpegPCMAudio("local_file.mp3")
  voice_client.play(audio_source)
  # 带结束回调的正确写法
  voice_client.play(audio_source, after=lambda e: print(f"播放完成" if not e else f"错误: {e}"))
  

  避免漏传source或把回调等参数放在source之前（比如voice_client.play(after=...)会直接触发报错）。
• 确认VoiceClient有效性：调用play()前，确保bot已成功连接到目标语音频道，获取到可用的VoiceClient实例：

  @bot.command()
  async def play(ctx):
      if not ctx.author.voice:
          await ctx.send("先加入语音频道再用指令！")
          return
      # 获取已连接的客户端，或新连接频道
      voice_client = ctx.voice_client or await ctx.author.voice.channel.connect()
      # 加载并播放音频
      source = discord.FFmpegPCMAudio("test.mp3")
      voice_client.play(source)
  

• 验证FFmpeg路径：即使配置了环境变量，也可手动指定FFmpeg路径排除问题：

  # Windows示例，Linux/Mac直接写"ffmpeg"即可
  source = discord.FFmpegPCMAudio("test.mp3", executable="C:/path/to/ffmpeg.exe")
  

2. 无需下载音频实现播放（保持download=False） #

可以通过提取YouTube音频的流媒体链接，直接用FFmpeg流式播放，无需下载文件。推荐使用yt-dlp（YoutubeDL的活跃分支，对YouTube反爬支持更好），实现步骤如下：

示例代码 #

import yt_dlp
import discord

# 配置yt-dlp参数
ydl_config = {
    'format': 'bestaudio/best',
    'noplaylist': True,
    'quiet': True,
    'download': False,
    'postprocessors': [{
        'key': 'FFmpegExtractAudio',
        'preferredcodec': 'mp3',
        'preferredquality': '192',
    }],
}

@bot.command()
async def play(ctx, *, search_query):
    # 检查用户语音状态
    if not ctx.author.voice:
        await ctx.send("先加入语音频道！")
        return
    target_channel = ctx.author.voice.channel
    voice_client = ctx.voice_client or await target_channel.connect()

    # 提取音频流链接
    with yt_dlp.YoutubeDL(ydl_config) as ydl:
        media_info = ydl.extract_info(search_query, download=False)
        # 处理搜索结果（取第一个条目）
        if 'entries' in media_info:
            media_info = media_info['entries'][0]
        stream_url = media_info['url']
        # 配置FFmpeg流媒体参数，支持自动重连
        audio_source = discord.FFmpegPCMAudio(
            stream_url,
            before_options='-reconnect 1 -reconnect_streamed 1 -reconnect_delay_max 5',
            options='-vn'  # 忽略视频流，只处理音频
        )
        # 启动播放
        voice_client.play(audio_source)
        await ctx.send(f"正在播放：{media_info['title']}")

关键说明 #

• before_options中的参数用于在流媒体断开时自动重连，提升播放稳定性；
• options='-vn'告诉FFmpeg只处理音频流，忽略视频数据；
• 若坚持使用原版YoutubeDL，只需将yt_dlp替换为youtube_dl，但原版对YouTube新的反爬机制支持不足，容易出现提取失败的情况。

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