You need to enable JavaScript to run this app. 开发Python语音聊天机器人 执行Discord join命令报AttributeError
优惠活动
大模型
产品
解决方案
定价
更多

开发Python语音聊天机器人 执行Discord join命令报AttributeError

问题根因

该报错来自API版本不兼容:你编写的代码完全基于discord.py 1.x旧版本的接口实现,而当前环境安装的是2.0及以上版本的discord.py,旧版接口已被完全移除:

  • 旧版Member对象直接暴露voice_channel属性的设计已废弃,用户的语音状态统一封装在Member.voice返回的VoiceState实例中
  • 旧版Client.join_voice_channel()全局方法已被删除,语音连接逻辑调整为频道实例的内置方法
修复步骤

调整频道获取逻辑

将原代码中获取用户所在语音频道的写法替换为新版API规范:

  • 错误写法(v1版本):ctx.message.author.voice.voice_channel
  • 正确写法(v2版本):ctx.author.voice.channel

必须增加前置判断:如果触发命令的用户没有加入任何语音频道,ctx.author.voice会返回None,直接取属性会触发空值异常。

调整语音连接逻辑

将原代码中调用全局join_voice_channel的旧写法,替换为通过频道实例调用connect()方法完成连接。

修复后的可运行代码

from discord.ext import commands

@client.command()
async def join(ctx):
    # 校验用户是否已加入语音频道
    if not ctx.author.voice:
        await ctx.send("请先加入语音频道后再使用此命令")
        return
    
    join_channel = ctx.author.voice.channel
    # 处理机器人已处于语音连接状态的场景,避免重复连接报错
    if ctx.voice_client:
        await ctx.voice_client.move_to(join_channel)
    else:
        await join_channel.connect()
常见配套注意事项
  • 2.0版本的discord.py不需要在命令装饰器中传入pass_context=True,上下文对象ctx会自动作为参数注入
  • 需在Discord开发者后台的机器人权限配置中,开启语音频道的连接、发言权限,否则代码逻辑正确也会因权限不足无法加入频道

内容的提问来源于stack exchange,提问作者Desperat Studio

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.03 05:27:01