You need to enable JavaScript to run this app. discord.py开发:处理未知命令时报'Command'无CommandNotFound属性错误
优惠活动
大模型
产品
解决方案
定价
更多

discord.py开发:处理未知命令时报'Command'无CommandNotFound属性错误

报错核心原因

这个报错和你的错误判断逻辑无关,本质是代码变量名与导入的discord.ext.commands模块发生命名冲突,直接覆盖了模块本身。
报错信息AttributeError: 'Command' object has no attribute 'CommandNotFound'已经明确指向问题:当前代码中引用的commands不是你导入的存放各类错误类的模块,而是一个被命名为commands的Bot类实例,Bot实例本身没有CommandNotFound这个类属性,自然会抛出找不到属性的错误。

典型触发场景

出现这个问题的常见写法是在初始化Bot时,错误地把Bot实例命名为commands:

# 错误写法:把Bot实例赋值给commands变量,直接覆盖了之前导入的同名模块
commands = commands.Bot(command_prefix="!")

这行代码执行后,后续所有代码里提到的commands,都会被解析为这个Bot实例,不再是最开始导入的错误类所在模块。不管是判断未知命令用到的CommandNotFound,还是之前尝试做命令冷却提示时用到的CommandOnCooldown,都会触发相同的属性报错,和你描述的之前做冷却功能也碰到同款报错的现象完全匹配。

修正方法

  • 将Bot实例的变量名改为不会与导入模块冲突的bot,避免命名覆盖:
    # 正确的Bot初始化写法
    bot = commands.Bot(command_prefix="!")
    
  • 排查全代码是否有其他位置把commands作为变量名重新赋值,只要保证commands始终指向导入的discord.ext.commands模块,你写的错误处理逻辑不需要做任何改动就能正常运行。

快速验证方式

如果拿不准是不是命名冲突,可以在报错的判断行前加一句print(type(commands)):

  • 输出为<class 'module'>,说明模块引用正常
  • 输出为Bot类实例的类型,就百分百是变量覆盖模块的问题

修正后的错误处理代码参考:

@bot.event
async def on_command_error(ctx, error):
    if isinstance(error, commands.CommandNotFound):
        embed=discord.Embed(title="Command not found, silly.", description=f"Please use existing commands. {ctx.author.mention}", color=0xd93600)
        embed.set_footer(text="Guessity.")
        await ctx.send(embed=embed)

后续补充冷却触发的提示逻辑时,只要保证commands的模块引用正常,isinstance(error, commands.CommandOnCooldown)的判断也不会再触发属性报错。


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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.07 17:06:03