使用youtube-dl搭配discord.py实现语音播放时触发TLS/HTTPS I/O连接错误的问题求助
报错根因定位与修复方案
报错本质说明
控制台输出的
tls/https层反复重连的告警,全部来自FFmpeg拉取网络音频流的网络传输层,不是youtube-dl解析视频元数据阶段的错误。核心触发原因是FFmpeg拿到了无效/过期的YouTube音频流地址,连接被服务端中断后按照内置重连规则反复尝试连接,最终输出I/O错误告警。
现有代码的核心问题
- 错误提取音频流地址:代码中写的
info['formats'][0]['url']完全不符合youtube-dl的返回结构规则。YouTube返回的formats列表第一个条目通常是低码率视频流、甚至是已过期的预加载占位地址,根本不是之前YDL_OPTIONS里指定的bestaudio对应的有效地址,FFmpeg拉取这种无效地址自然会反复触发I/O中断。 - YDL_OPTIONS参数类型错误:代码里写的
'noplaylist':'True'是字符串类型,youtube-dl要求该参数为布尔值才会生效,实际运行时这个参数完全没有作用,遇到带播放列表后缀的链接会触发不必要的额外解析逻辑。 - 错误的语音静音配置:代码中启动播放后立刻调用变更状态将bot设为self_mute=True,这个参数的作用是将bot自身的音频发送通道静音,设置后bot根本无法把音频推送到语音频道,同时FFmpeg的拉流连接也会因为客户端语音状态异常快速中断,进一步触发反复重连的I/O报错。
- 冗余语音状态切换:代码中连续两次调用
change_voice_state切换静音、耳麦状态的逻辑完全多余,反复变更语音网关的连接参数会触发网关侧的连接抖动,反而降低音频流拉取的稳定性。 - 缺少基础异常校验:代码没有判断用户是否处于语音频道、bot是否已经成功连接语音频道,遇到用户不在频道的场景会直接触发空指针错误中断运行。
修正后可运行的代码
import discord from discord.ext import commands from youtube_dl import YoutubeDL # 全局复用播放配置,避免每次触发指令都重复定义 YDL_OPTIONS = { 'format': 'bestaudio', 'noplaylist': True, 'quiet': True, 'no_warnings': True } FFMPEG_OPTIONS = { 'before_options': '-reconnect 1 -reconnect_streamed 1 -reconnect_delay_max 5', 'options': '-vn' } @commands.command(brief="播放YouTube链接对应的音频") async def play(ctx, url): # 校验用户语音状态 if not ctx.author.voice: await ctx.send("你需要先加入语音频道才能触发播放指令") return target_channel = ctx.author.voice.channel voice = discord.utils.get(ctx.bot.voice_clients, guild=ctx.guild) # Bot未连接时自动加入语音频道,直接默认开启服务器端耳麦屏蔽,无需后续反复切换状态 if not voice: voice = await target_channel.connect(self_deaf=True) if voice.is_playing(): await ctx.send("当前已经在播放音频,暂时无法加载新内容") return # 解析元数据获取有效音频直链 with YoutubeDL(YDL_OPTIONS) as ydl: info = ydl.extract_info(url, download=False) # 直接取youtube-dl匹配指定format后的有效直链,不再手动从formats数组中随机取条目 stream_url = info.get('url') voice.play(discord.FFmpegPCMAudio(stream_url, **FFMPEG_OPTIONS)) await ctx.send(f"开始播放:{info.get('title')}")
修复后的效果
- 直接获取匹配
bestaudio规则的有效流地址,从根源上解决FFmpeg拉取无效地址导致的I/O重连报错 - 修正参数类型错误,确保youtube-dl的配置全部生效
- 移除错误的自静音配置,保障bot可以正常将音频推送到语音频道
- 去掉冗余的语音状态切换逻辑,减少语音网关的连接抖动
- 增加基础状态校验,避免代码运行时触发空值崩溃
内容的提问来源于stack exchange,提问作者Foxxything
相关产品推荐
相关产品推荐

