机器人无法分配角色排查：已赋API管理员权限仍执行命令报错

嘿，我之前也碰到过一模一样的情况！哪怕给机器人开了管理员权限，加角色还是报错，核心原因大概率是角色层级的问题，这是Discord权限系统里很容易踩的坑。

先看你的测试代码：

@client.command()
async def test(ctx):
    user = ctx.author
    role = get(ctx.guild.roles, name='+$50.000')
    await user.add_roles(role)

Discord有个硬性规则：机器人绝对不能给用户添加比自己角色位置更高的角色，哪怕你给它开了管理员权限也没用——管理员权限的生效前提是角色层级允许，它没法绕过这个规则。

怎么排查和解决？ #

• 打开服务器的「角色」设置页面，找到机器人的角色，看看它在列表里的位置
• 对比+$50.000这个角色的位置：如果目标角色在机器人角色的上方（列表越靠上权限层级越高），那机器人就没权限操作它
• 解决办法很简单：把机器人的角色拖动到+$50.000角色的上方，保存设置后再跑命令试试

额外的优化建议 #

1. 用角色ID代替名字查找：名字可能有拼写误差，或者服务器里有重名角色，用ID更靠谱。修改后的代码示例：

@client.command()
async def test(ctx):
    user = ctx.author
    # 把下面的数字换成你实际的+$50.000角色ID
    target_role = ctx.guild.get_role(123456789012345678)
    if target_role:
        await user.add_roles(target_role)
    else:
        await ctx.send("找不到目标角色哦，检查下角色ID是否正确！")

2. 加个错误处理：方便你快速定位问题类型，比如：

@test.error
async def test_cmd_error(ctx, error):
    if isinstance(error, commands.MissingPermissions):
        await ctx.send("我没有足够权限执行这个操作！")
    elif isinstance(error, Forbidden):
        await ctx.send("没法加角色，大概率是我角色层级比目标角色低啦！")
    else:
        await ctx.send(f"出问题啦：{str(error)}")

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