discord.py开发机器人触发Missing Permissions权限错误如何处理

现有代码的核心问题 #

• 错误引用了不存在的Forbidden.MissingPermissions类，discord.errors.Forbidden是独立的异常类，没有名为MissingPermissions的子类，所以触发该异常时无法匹配到对应分支，会直接抛出未处理的报错。
• 仅覆盖了命令框架层的commands.BotMissingPermissions校验异常，没有覆盖Discord API调用时实际触发的底层discord.errors.Forbidden异常，这类异常通常在执行具体操作（比如修改用户角色、删除消息、发送消息到无权限频道）时触发。
• 错误处理逻辑中的ctx.send()、ctx.message.delete()操作本身也可能触发权限异常，没有做防护，容易引发二次报错。

修正后的错误处理实现 #

首先确保你已经导入了对应异常：

from discord import Forbidden
from discord.ext import commands

然后修改on_command_error事件：

@client.event
async def on_command_error(ctx, error):
    # 提取原始异常（部分场景下异常会被框架包装）
    original_error = getattr(error, 'original', error)
    
    # 封装安全回复+删消息逻辑，避免二次权限报错
    async def safe_reply(content):
        try:
            await ctx.send(content)
        except Forbidden:
            # 连发消息权限都没有则直接跳过
            pass
        try:
            await ctx.message.delete()
        except Forbidden:
            # 没有删消息权限也直接跳过
            pass
    
    if isinstance(error, commands.MissingPermissions):
        await safe_reply("You can't do that ;-;")
    elif isinstance(error, commands.MissingRequiredArgument):
        await safe_reply("Please enter all the required arguments")
    elif isinstance(error, commands.MemberNotFound):
        await safe_reply("Member not found, Please mention a valid user!")
    elif isinstance(error, commands.BotMissingPermissions):
        await safe_reply("I don't have the permissions to do that!")
    # 捕获底层Forbidden异常
    elif isinstance(original_error, Forbidden):
        # 匹配静音命令的特殊场景，返回角色层级相关提示
        if ctx.command.name == 'mute': # 替换为你实际的静音命令名称
            # 根据你的命令参数逻辑调整目标用户的取值方式
            target = ctx.kwargs.get('member') or ctx.args[2]
            if ctx.guild.me.top_role.position <= target.top_role.position:
                await safe_reply("无法执行操作，请将我的角色置于指定角色上方")
                return
        # 其他通用权限不足场景
        await safe_reply("I don't have the permissions to do that!")
    else:
        raise error

优化建议 #

你可以在执行具体操作前（比如执行静音前）先做前置校验，不需要等抛出异常再处理，使用体验更流畅：

# 静音命令内部前置校验示例
@client.command()
async def mute(ctx, member: discord.Member, *, reason=None):
    # 先判断角色层级
    if ctx.guild.me.top_role.position <= member.top_role.position:
        await ctx.send("无法执行操作，请将我的角色置于指定角色上方")
        await ctx.message.delete()
        return
    # 再判断对应权限是否齐全
    if not ctx.guild.me.guild_permissions.manage_roles:
        await ctx.send("我没有管理角色的权限，无法执行静音操作")
        await ctx.message.delete()
        return
    # 后续执行静音逻辑

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