Discord.py编写join_team身份组加入功能报NoneType不可迭代错误如何解决

错误根因分析 #

你的代码存在3个核心错误，直接触发了本次报错：

• 重复获取身份组导致返回空值：你已经给rule参数加上了discord.Role类型注解，discord.py框架会自动将用户输入的身份组转换为可用的discord.Role对象，不需要再调用ctx.guild.get_role()二次查询。而且get_role()方法要求传入的是数字类型的身份组ID，你传入Role对象只会返回None，这就是报错中NoneType的来源。
• 身份组持有校验逻辑错误：不能用ctx.author in role的写法判断用户是否持有对应身份组，正确逻辑是判断目标身份组是否在用户的roles属性列表中。
• 角色添加API调用错误：discord.py v1.0及以上版本中，添加身份组的方法已经改为用户对象的内置方法，不需要通过client实例调用。

修复后可运行代码 #

@commands.command()
async def join_team(self, ctx, role: discord.Role):
    # 先判断机器人是否有管理角色的权限
    if not ctx.guild.me.guild_permissions.manage_roles:
        await ctx.send("我没有管理角色的权限，无法完成操作")
        return
    # 机器人角色层级必须高于目标角色
    if role.position >= ctx.guild.me.top_role.position:
        await ctx.send("我的角色层级低于目标身份组，无法分配该身份组")
        return
    # 校验用户是否已经持有该身份组
    if role in ctx.author.roles:
        await ctx.send("你已经属于该身份组！")
        return
    # 校验身份组成员是否已满5人
    if len(role.members) >= 5:
        await ctx.send("该身份组成员已达上限")
        return
    # 所有校验通过，添加身份组
    await ctx.author.add_roles(role)
    await ctx.send(f"成功加入身份组 {role.name}")

额外注意事项 #

• 如果你使用的是discord.py v2.0及以上版本，需要在机器人初始化时开启message_content意图，否则前缀命令无法正常触发。
• 如果需要兼容用户输入身份组名称而非@提及的场景，可以去掉参数的discord.Role类型注解，自行根据输入内容查询匹配的身份组即可。

内容的提问来源于stack exchange，提问作者Dave