Discord.py开发:如何让revive命令的无权限调用不触发冷却
问题根因
原代码的核心问题是@commands.cooldown属于命令前置检查,会在命令体执行前就运行,且默认无前置权限拦截逻辑:只要用户调用命令,不管后续权限判断是否通过,都会先消耗1次guild级冷却额度,导致无权限用户的调用直接占用整个服务器的冷却次数。
推荐解决方案
将权限校验逻辑移到冷却检查的前置环节,保证无权限用户的调用在触达冷却逻辑前就被拦截,完全不参与冷却计数。
修改后的代码示例
from discord.ext import commands import discord @client.command() # 前置权限校验,放在冷却装饰器上层,保证先执行 @commands.check(lambda ctx: ctx.author.guild_permissions.mention_everyone) # 权限校验通过后才会触发冷却检查/计数 @commands.cooldown(1.0, 3600.0, commands.BucketType.guild) async def revive(ctx): await ctx.send( "I shall revive the CHAT, <@800171737832226827> <@&800168050077728808>" ) # 新增命令错误处理,返回无权限的自定义提示 @revive.error async def revive_error_handler(ctx, error): # 捕获无权限错误,发送自定义Embed if isinstance(error, commands.MissingPermissions): # 修正原代码的decription拼写错误为description embed = discord.Embed(description=None, color=discord.Colour.blue()) embed.add_field( name="Error!", value="You do not have the permissions to do this! You need the permission: **Mention Everyone**" ) await ctx.send(embed=embed) # 可选:补充冷却期调用的提示逻辑 elif isinstance(error, commands.CommandOnCooldown): await ctx.send(f"命令冷却中,请等待 {round(error.retry_after, 1)} 秒后再试。")
方案说明
- 装饰器执行顺序:
@commands.check在@commands.cooldown上层,会先运行权限校验,无权限用户直接被抛出MissingPermissions错误,完全不会触达冷却逻辑,也就不会消耗冷却额度。 - 修正了原代码中
Embed的参数拼写错误(decription→description),避免参数不生效或报错。 - 无权限用户仍然能收到原本设计的错误提示,体验和原逻辑一致。
其他可选方案(不推荐)
如果不想使用装饰器实现前置校验,也可以移除内置的@commands.cooldown装饰器,在命令体内部先判断权限,有权限的情况下再手动实现冷却逻辑。但该方案需要自行处理冷却的存储、计时等逻辑,不如内置装饰器稳定,仅适合有特殊定制需求的场景。
内容的提问来源于stack exchange,提问作者Baqir Zaidi
相关产品推荐
相关产品推荐

