You need to enable JavaScript to run this app. Discord.py @clear.error装饰的错误处理函数未生效求助
优惠活动
大模型
产品
解决方案
定价
更多

Discord.py @clear.error装饰的错误处理函数未生效求助

Discord Bot clear命令权限错误处理不触发的排查与修复

常见问题根源

  • 抄来的旧代码参数顺序写反。你用的Abdulaziz提供的这段代码,参数顺序完全不符合现在discord.py的要求:单命令错误回调固定要求先传ctx(命令上下文),再传error(抛出的错误对象)。现在的写法把俩参数顺序搞反,框架调用的时候会把上下文塞给error形参,把错误对象塞给ctx形参,后面的类型判断根本匹配不上,甚至会因为参数不兼容,整个错误回调压根注册不上,自然一点反应都没有。
  • 导错了错误类。很多人容易把斜杠命令模块下的MissingPermissions和文本前缀命令模块下的同名错误类搞混。如果你写的是普通文本命令,却导入了斜杠命令的权限错误类,哪怕逻辑跑通了,类型判断也永远对不上,进不了发提示消息的分支。
  • 全局错误处理器把错误吞了。如果你的Bot已经写了全局的on_command_error事件,在里面拦了所有权限错误直接返回,没有给单命令的自定义错误处理器留透传通道,那单命令绑的错误回调根本没机会执行。

对应修复步骤

  • 把错误回调的俩参数顺序调换,严格按框架要求改成async def clear_error(ctx, error):
  • 检查MissingPermissions的导入路径:文本前缀命令用的权限错误,要从discord.ext.commands下导入,别导discord.app_commands里的同名类。
  • 如果有全局错误处理逻辑,加一句透传逻辑:碰到带独立错误处理器的命令,用ctx.command.dispatch_error(ctx, error)把错误传给对应命令的处理器,别在全局逻辑里把所有错误都拦死。

修复后可直接运行的代码示例

from discord.ext import commands
from discord.ext.commands import MissingPermissions, has_permissions

# 按Bot运行需要开启对应intents
intents = commands.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix="!", intents=intents)

@bot.command()
@has_permissions(manage_messages=True) # 绑定命令需要的权限校验
async def clear(ctx, clear_count: int):
    # 批量清理频道消息
    await ctx.channel.purge(limit=clear_count + 1)
    await ctx.send(f"已清除{clear_count}条消息", delete_after=3)

# 可正常触发的错误处理器
@clear.error
async def clear_error(ctx, error):
    if isinstance(error, MissingPermissions):
        await ctx.send(f"Sorry {ctx.author.mention}, you do not have permissions to do that!")

bot.run("你的Bot运行Token")

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.17 21:54:03