You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

discord.py运行cog指令时报The check functions for command failed错误如何解决

错误原因

你抛出的CheckFailure错误是Cog全局校验未通过导致的:
你在start这个Cog中定义了cog_check方法,这是作用于整个Cog的全局校验规则,要求调用指令的用户ID必须和你主程序中预设的bot.author_id完全相等,校验不通过就会直接抛出这个错误,不会执行指令后续代码。
常见触发场景有三个:

  • 主程序中bot.author_id = DISCORD ID的占位符未替换为你自己的真实Discord用户ID
  • 替换ID时错误地给ID加了引号,变成了字符串类型,而ctx.author.id是整数类型,类型不一致导致相等判断失败
  • 使用了非对应ID的其他账号测试指令,不符合校验规则
修复方案

分两种场景处理:

场景1:需要保留「仅机器人所有者可调用该Cog指令」的限制

修改主程序中author_id的赋值代码:

  1. 将占位符DISCORD ID替换为你自己的Discord数字ID,不要加引号,保持整数类型,示例:
bot.author_id = 123456789012345678 # 替换为你自己的ID
  1. 测试指令时必须使用对应ID的账号操作。

场景2:不需要权限限制,允许所有用户调用该Cog的指令

直接删除Cog代码中的整个cog_check方法即可,删除后的Cog代码示例:

import discord
from discord.ext import commands


class start(commands.Cog, name='start Commands'):
    '''These are the start commands'''

    def __init__(self, bot):
        self.bot = bot

    @commands.command(name="avatar", aliases=['av']) 
    async def avatar(self, ctx):
        print("bruh")


def setup(bot):
    bot.add_cog(start(bot))

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.01 23:09:03