Discord.py音乐机器人无法播放YouTube音频无报错问题求助

问题排查与解决方案 #

1. 缺失必要后端依赖 #

pafy本身仅提供封装逻辑，需要搭配yt-dlp（原youtube-dl已停止维护，不推荐使用）作为底层解析依赖，未安装该依赖时会出现静默拿不到有效流地址的情况：

• 执行命令安装yt-dlp：pip install yt-dlp
• 在代码初始化阶段添加配置指定pafy使用yt-dlp作为后端：

import pafy
pafy.set_backend("yt-dlp")

2. FFmpeg配置/安装问题 #

discord.py的语音依赖不会自带FFmpeg二进制文件，且参数配置错误也会导致无输出：

• 先确认FFmpeg已安装且加入系统环境变量，终端执行ffmpeg -version有正常输出版本信息即为安装成功，未安装需要单独下载对应系统版本的FFmpeg完成配置。
• 确认FFMPEG_OPTIONS参数配置正确，缺少重连参数会导致YouTube流式传输直接中断无输出，标准配置参考：

self.FFMPEG_OPTIONS = {
    "before_options": "-reconnect 1 -reconnect_streamed 1 -reconnect_delay_max 5",
    "options": "-vn"
}

3. Discord权限与意图配置缺失 #

• 检查Discord开发者后台的机器人权限配置，确保开启了Connect、Speak、Send Messages三个核心权限，邀请机器人进服的OAuth2链接需要勾选bot和applications.commands两个scope，同时要在服务器的语音频道设置中确认机器人没有被禁言、没有被限制加入频道。
• 如果你使用的是discord.py 2.0及以上版本，需要在初始化Bot时开启语音状态意图：

import discord
from discord.ext import commands

intents = discord.Intents.default()
intents.voice_states = True # 必须开启语音状态意图
bot = commands.Bot(command_prefix="!", intents=intents)

4. 代码逻辑潜在问题 #

• 当前用正则匹配YouTube搜索结果的方式不稳定，YouTube页面结构更新后会匹配到无效的video_id，可先打印video_ids[0]和audio.url确认解析到的地址是否可以正常访问。
• 执行播放逻辑前增加连接状态校验，避免voice_client未连接成功就执行播放：

if voice_client and voice_client.is_connected() and not voice_client.is_playing():
    voice_client.play(source)

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