You need to enable JavaScript to run this app. 使用youtube-dl搭配discord.py实现语音播放时触发TLS/HTTPS I/O连接错误的问题求助
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 12:15:03