如何检查Discord中执行命令的用户是否拥有指定角色以限制命令使用

方案1：使用内置权限装饰器（推荐） #

discord.py 提供了内置的角色校验装饰器，无需手动编写判断逻辑，只要用户不满足角色要求，会直接拦截命令执行流程。

• 首先需要从模块中导入权限校验函数：from discord.ext.commands import has_role
• 在命令定义上方添加@has_role(你的权限角色ID)装饰器即可，参数支持填写角色唯一ID（推荐）或角色名称
• 可配套添加命令错误监听，给无权限用户发送友好提示，而非让错误信息直接输出到控制台

对应的完整修改后代码示例：

# 提前定义常量，替换为你自己的实际角色ID
PERMISSION_ROLE_ID = 可执行mute命令的权限角色ID
MUTED_ROLE_ID = 服务器用于标记静音状态的角色ID

@client.command()
# 校验规则：仅持有指定权限角色的用户可执行命令
@commands.has_role(PERMISSION_ROLE_ID)
async def mute(ctx, member: discord.Member):
    muted_role = ctx.guild.get_role(MUTED_ROLE_ID)
    await member.add_roles(muted_role)
    await ctx.send(f"{member.mention} 已被静音")

# 针对mute命令的权限不足错误处理
@mute.error
async def mute_error(ctx, error):
    if isinstance(error, commands.MissingRole):
        await ctx.send("你没有执行该命令的权限")

方案2：命令内部手动校验 #

如果需要在校验角色的同时，执行额外的自定义逻辑，可以在命令函数开头手动判断执行用户的角色持有情况：

@client.command()
async def mute(ctx, member: discord.Member):
    # 获取需要校验的权限角色
    permission_role = ctx.guild.get_role(可执行命令的权限角色ID)
    # 判断执行命令的用户是否持有该角色
    if permission_role not in ctx.author.roles:
        await ctx.send("你没有执行该命令的权限")
        # 直接终止后续逻辑执行
        return
    
    muted_role = ctx.guild.get_role(MUTED_ROLE_ID)
    await member.add_roles(muted_role)
    await ctx.send(f"{member.mention} 已被静音")

常见注意事项 #

• 角色匹配优先使用唯一ID，不要直接匹配角色名称，避免因角色重名、名称修改导致校验失效
• 校验对象永远是ctx.author（即触发命令的用户），不要错将被操作的member对象作为校验主体
• 机器人自身的角色层级，必须高于你要添加的静音角色，否则会因Discord权限规则限制，无法成功给目标用户添加角色
• 如果希望服务器管理员无需持有指定角色也能执行命令，可搭配commands.check_any组合校验逻辑，例如：

@commands.check_any(
    commands.has_role(PERMISSION_ROLE_ID),
    commands.has_permissions(administrator=True)
)

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