You need to enable JavaScript to run this app. discord.py 为find命令添加@commands.cooldown装饰器后命令失效问题
优惠活动
大模型
产品
解决方案
定价
更多

discord.py 为find命令添加@commands.cooldown装饰器后命令失效问题

加冷却装饰器后find命令失效的常见原因&排查方案
  • 第一类问题:Cog加载阶段装饰器报错,find命令根本没完成注册
    这是最容易被忽略的问题。只要装饰器参数存在拼写错误、枚举值导入缺失,Python在执行类属性赋值阶段就会抛出异常,直接导致find命令没有被注册到bot的命令列表里,表现就是输入命令完全没反应,连之前正常的触发逻辑都彻底失效。
    尤其要注意确认导入的commands.cooldown和commands.BucketType是来自discord.ext.commands模块,而不是slash命令体系下的同名方法,导入路径错误也会直接导致装饰器执行失败,命令无法注册。
    排查方式:启动bot后,在控制台打印所有已注册的命令名称,确认find是否在列表内。如果不在,直接查看控制台启动时的报错日志,定位装饰器相关的语法或导入错误即可。
  • 第二类问题:命令错误处理逻辑异常吞掉了所有执行异常
    很多人写find命令的专属错误处理、Cog级别的全局命令错误处理时,没有做异常类型判断就直接拦截所有错误,导致cooldown初始化、命令执行阶段抛出的非冷却类异常被静默吃掉,从表面上看就是命令触发后完全没有反馈。
    正确的错误处理逻辑应该只针对性处理CommandOnCooldown类型的错误,其他异常直接向上抛出交给全局日志系统输出,参考写法:
    @find.error
    async def find_cooldown_handler(self, ctx, error):
        if isinstance(error, commands.CommandOnCooldown):
            retry_time = round(error.retry_after, 1)
            await ctx.send(f"找东西的冷却还没到,还有{retry_time}秒可以用")
        else:
            # 不拦截其他错误,保留日志输出
            raise error
    
  • 第三类问题:search命令的内部调用方式破坏了cooldown的上下文
    如果你在search命令里直接通过调用self.find.callback(self, ctx)的方式触发find命令,会跳过cooldown装饰器的外层检查逻辑,导致冷却系统找不到对应的用户bucket初始化值,抛出内部KeyError。这类异常会被之前提到的错误处理逻辑吞掉,连带正常的find命令触发流程一起失效。
    正确的跨命令调用方式应该走标准的bot命令调用流,不要直接触碰内部回调方法:
    @commands.command()
    async def search(self, ctx):
        # 构造标准上下文,替换命令为find后触发
        find_ctx = await self.bot.get_context(ctx.message, command=self.find)
        await self.bot.invoke(find_ctx)
    
  • 快速排查步骤参考
    • 先临时注释掉@commands.cooldown装饰器,确认find命令能正常触发,排除其他基础逻辑的问题
    • 临时移除所有自定义的错误处理逻辑,触发命令时观察控制台是否有隐藏的异常日志
    • 确认on_message逻辑中,处理完"nut"关键词的反应后,没有提前return跳过await bot.process_commands(message)的流程,避免命令根本没进入bot的处理链路

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.03 18:06:03