如何检查bot权限 实现无权限提示、有权限执行动作逻辑

核心逻辑是在所有操作逻辑执行前增加前置权限校验分支，不要等调用平台接口抛错后再做异常捕获处理，稳定性更高。

实现步骤 #

• 指令触发后，第一时间获取机器人当前所在上下文（服务器/频道/群聊）内的实际持有权限集合，不要延后到操作执行阶段再查询
• 匹配当前待执行操作要求的权限项，和机器人实际权限做比对：绝大多数机器人平台的权限采用位掩码设计，直接通过位与运算即可快速完成校验，不需要遍历全量权限列表
• 分支处理逻辑：
  • 校验不通过：直接发送明确的权限不足提示，终止后续所有操作逻辑，不再调用平台操作接口
  • 校验通过：正常执行预设的操作流程即可

核心代码示例（适配绝大多数位掩码权限设计的Bot平台） #

# 替换为目标操作对应的权限位值，比如管理消息、踢人、发文件等对应权限编码
REQUIRED_PERMISSION = 0x0000000000000020

async def command_entry(ctx):
    # 获取当前上下文下机器人的权限值
    bot_permission_value = ctx.guild.me.permissions_in(ctx.channel).value
    # 位运算判断是否持有目标权限
    if not (bot_permission_value & REQUIRED_PERMISSION):
        await ctx.send("❌ 权限不足，请为Bot授予本次操作所需的对应权限后重试")
        # 终止后续流程
        return
    # 校验通过，执行实际操作
    await run_target_operation(ctx)

注意事项 #

• 不要依赖平台接口返回的错误做后置权限判断，部分平台返回的错误没有明确的权限错误标识，很容易把网络错误、参数错误等其他问题误判为权限问题
• 如果操作包含多个步骤，每一步涉及新的权限要求时都要单独做校验，不要只校验第一步权限
• 权限不足提示建议明确标注需要的具体权限名称，方便服务器管理员快速调整配置，减少排查成本

内容的提问来源于stack exchange，提问作者zayne