You need to enable JavaScript to run this app. 开发Discord机器人添加用户角色时遇AttributeError: 'NoneType'报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

开发Discord机器人添加用户角色时遇AttributeError: 'NoneType'报错如何解决

报错根因定位

本次报错的触发链路非常明确:
代码执行到var = discord.utils.get(message.guild.roles, name="verifyed")时,没有在当前服务器的角色列表中匹配到名称完全为verifyed的角色,函数返回了None。后续调用member.add_roles(var)时,底层需要读取传入角色对象的id属性,None对象没有对应属性,直接抛出AttributeError。

分步修复方案
  • 第一优先级:核对角色名称的准确拼写
    打开Discord服务器的角色管理页,确认要分配的目标角色的精确名称。代码里匹配的verifyed大概率是拼写错误:“已验证”的通用英文拼写是verified,仅差一个字母就会导致角色匹配完全失败,把代码里的角色名修改为和服务器内角色100%一致的字符串即可解决最核心的匹配问题。
  • 第二优先级:检查机器人的权限与配置
    首先确认机器人在开发者后台已经开启服务器成员意图(Server Members Intent),未开启该意图时,机器人无法拉取完整的服务器角色列表,会出现明明角色存在但匹配不到的问题;其次确认机器人被授予了“管理角色”权限,且机器人自身的角色在服务器的角色排序中,位置高于要分配的目标角色——按照Discord的权限规则,机器人无法为成员添加位置比自身角色更高的角色。
  • 修复代码里潜伏的其他运行错误
    这些问题虽然没有触发本次报错,但后续运行时必然会抛出异常:
    1. 原代码里的wait_until_ready()写法无效:既没有指定调用的bot实例,也没有加异步等待的await关键字,完全起不到等待机器人连接完成的作用,应该替换为await bot.wait_until_ready()
    2. 嵌入消息发送参数错误:原写法await message.channel.send(message.channel, embed=embed)在第一个位置参数错误传入了频道对象,正确写法应该是await message.channel.send(embed=embed)
    3. Embed对象的字符串未闭合:原代码里的描述字符串'User verifyed! Use **//verify to verify your self!'缺少结尾单引号,同时粗体标记**没有闭合,会直接触发Python语法错误
  • 增加防御性校验提升代码稳定性
    拿到角色对象后先做存在性判断,如果角色不存在就直接返回提示,不要直接执行添加角色的逻辑,避免无意义的崩溃:
    target_role = discord.utils.get(message.guild.roles, name="verified")
    if target_role is None:
        await message.channel.send("当前服务器未配置已验证角色,请联系管理员处理")
        return
    await member.add_roles(target_role)
    

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.31 08:36:02