You need to enable JavaScript to run this app. Discord.py自定义on_message事件导致所有机器人命令失效问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

Discord.py自定义on_message事件导致所有机器人命令失效问题咨询

问题核心原因

重写Discord.py机器人的on_message事件时,会完全覆盖框架内置的同名事件逻辑。框架默认在收到消息后,会通过内置的process_commands函数解析消息内容,判断是否匹配已注册的命令规则;自定义实现的on_message如果没有主动调用这个解析函数,所有命令都不会进入执行链路。你现有实现的on_message全程没有补全这个调用逻辑,哪怕是未被静音的用户发送命令,消息也会被当成普通聊天内容,最终出现机器人对所有注册命令完全无响应的问题。

具体排查要点
  • 检查自定义on_message的流程完整性:很多开发者写完静音拦截逻辑后会直接结束事件流程,忘记补全命令解析的调用步骤,导致所有消息都无法触发命令
  • 检查on_message的参数定义:该事件接收的入参是discord.Message消息对象,而不是命令交互上下文Context,你现有代码把参数命名为ctx属于认知偏差,虽然Python动态类型暂时不会报语法错误,但长期运行容易出现隐性属性读取异常
  • 检查消息删除操作的异常中断问题:如果机器人没有管理消息权限,执行删除被静音用户消息的操作时会抛出权限不足的异常,直接中断整个on_message的执行流程,连带让后续命令解析完全无法运行
修正后的可运行代码示例

修正后的静音拦截逻辑,可同时兼容原有命令的正常触发:

@client.event
async def on_message(message):
    # 跳过机器人自身发送的消息,避免递归触发流程
    if message.author.bot:
        return
    # 获取指定ID的静音角色
    muted_role = message.guild.get_role(673180122768998411)
    # 检查发送者是否持有静音角色
    if muted_role in message.author.roles:
        try:
            await message.delete()
        except discord.Forbidden:
            # 无消息删除权限时不中断后续流程
            pass
        # 静音用户的消息不做命令解析,直接结束流程
        return
    # 核心补全逻辑:手动触发内置的命令解析流程
    await client.process_commands(message)

额外补充:你现有示例命令里的passContent=True是Discord.py早期版本的废弃参数,当前正式版已移除该参数配置,删除该参数不会影响命令的正常运行。


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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.11 18:45:04