Discord.py中on_message场景下配置CooldownMapping防关键词刷屏
on_message 中集成关键词响应冷却的调整方案
原代码核心问题
- 嵌套定义在
on_message内部的cog_check函数从未被实际调用,冷却逻辑完全失效 - 误用Cog自带的
cog_check机制:该机制仅对内置命令生效,自定义监听器执行时不会自动触发其校验流程 - 缺少基础消息过滤逻辑,未排除机器人自身发送的消息,容易出现无限循环触发监听器的问题
正确实现逻辑
不需要依赖Cog的命令检查机制,直接在on_message的执行流中嵌入冷却判断即可,注意冷却校验的时机要放在关键词匹配完成之后——也就是只有用户发送的消息确实命中触发关键词时,才会占用冷却计数,避免把无意义的普通聊天算入限流规则。
调整后的参考代码如下:
class Listener(commands.Cog): def __init__(self, bot): self.bot = bot # 冷却规则:单用户维度,每10秒最多触发1次关键词响应 self._keyword_cd = commands.CooldownMapping.from_cooldown( 1.0, 10.0, commands.BucketType.user ) # 触发关键词列表,可根据实际需求维护 self.TRIGGER_KEYWORDS = {"要匹配的关键词1", "关键词2", "关键词3"} @commands.Cog.listener() async def on_message(self, message): # 第一步:基础消息过滤 # 忽略机器人自身发送的消息,避免死循环 if message.author.bot: return # 忽略私聊场景(对应你原代码中的guild判断逻辑) if message.guild is None: return # 第二步:匹配触发关键词,未命中则直接返回 is_trigger_hit = any(keyword in message.content for keyword in self.TRIGGER_KEYWORDS) if not is_triggered: return # 第三步:命中关键词后,校验用户冷却状态 bucket = self._keyword_cd.get_bucket(message) # 若仍在冷却期,返回剩余等待秒数;否则重置冷却计时返回None retry_after = bucket.update_rate_limit() if retry_after: # 冷却期内不触发响应,可选择发送友好提示 await message.channel.send( f"触发过于频繁,请在 {retry_after:.1f} 秒后再尝试", delete_after=5 ) return # 第四步:冷却校验通过,执行原有关键词响应逻辑 await message.channel.send("关键词对应的自定义响应内容")
可调整的细节说明
- 冷却规则参数可按需修改:
from_cooldown(允许触发次数, 冷却时长(秒), 分桶维度),如果需要按频道、服务器维度限流,只需把commands.BucketType.user替换为对应枚举值即可 - 如果不同关键词需要独立的冷却规则,可以为每个关键词单独创建
CooldownMapping实例,不要共用同一套冷却计数 - 提示消息可根据机器人的整体风格调整,不需要强制发提示的话,也可以在冷却期内直接静默不响应
内容的提问来源于stack exchange,提问作者Dan A
相关产品推荐
相关产品推荐

