Discord音乐bot按歌名播放触发KeyError: 'url'错误如何解决？

云上老周

2026-9-25

问题根因

当你传入搜索关键词而非直接传入视频URL时，youtube-dl的extract_info返回的元数据结构和URL模式不同：搜索结果会被包装为播放列表结构，单条视频的元数据存放在info['entries']列表中，直接访问info['url']自然会触发KeyError。

修复代码

修改extract_info后的取值逻辑即可兼容URL输入和关键词搜索两种场景，同时优化参数适配带空格的歌名：

@bot.command(name='play', help='Plays audio in connected voice channel')
async def play(ctx, *, q): # 加*让带空格的歌名可以正常传入
    YDL_OPTIONS = {'default_search': 'auto', 'format': 'bestaudio', 'noplaylist':'True'}
    FFMPEG_OPTIONS = {'before_options': '-reconnect 1 -reconnect_streamed 1 -reconnect_delay_max 5', 'options': '-vn'}
    voice = ctx.message.guild.voice_client

    if not voice:
        await ctx.send("请先让机器人加入语音频道")
        return
    
    with YoutubeDL(YDL_OPTIONS) as ydl:
        info = ydl.extract_info(q, download=False)
        # 判断是否是搜索结果的播放列表结构，是就取第一条
        if 'entries' in info:
            # 取第一条有效搜索结果
            video = info['entries'][0]
        else:
            # 直接是URL的情况
            video = info
        a = video['url']   
    if not voice.is_playing():
        voice.play(FFmpegPCMAudio(a, **FFMPEG_OPTIONS))
    else:
        await ctx.send("当前已有音频正在播放")

补充说明