You need to enable JavaScript to run this app. discord.py开发的机器人kick/ban命令报403权限不足,clear命令运行正常
优惠活动
大模型
产品
解决方案
定价
更多

discord.py开发的机器人kick/ban命令报403权限不足,clear命令运行正常

Discord 机器人kick/ban命令403权限报错排查

报错根因

触发discord.errors.Forbidden: 403 Forbidden (error code: 50013): Missing Permissions的核心原因,是机器人自身没有获得服务器层面的踢人、封禁操作权限,和你使用的Python 3.9.0版本、现有代码逻辑无关。

补充说明:你的.clear命令可正常运行,是因为机器人已被分配管理消息(Manage Messages)权限;代码中的@commands.has_permissions()装饰器仅用于校验执行命令的服务器成员是否有权限触发操作,不会为机器人本身授予任何服务器操作权限。

排查修复步骤

1. 给机器人角色配置对应权限

  • 打开对应Discord服务器的「服务器设置」→「角色」,找到机器人绑定的专属角色
  • 在角色权限列表中,开启以下权限:
    • 踢成员(Kick Members):支撑kick命令运行
    • 封禁成员(Ban Members):支撑ban命令运行
  • 调整角色优先级:在角色列表中将机器人的角色拖拽到较高位置,确保其层级高于所有需要被踢/封禁的目标成员。如果目标成员的角色层级高于机器人,即使拥有踢人权限,Discord也会拦截操作抛出权限错误。

2. 修正代码执行顺序

你当前的代码逻辑是“先发送踢出提示,再执行实际踢人操作”,一旦操作失败就会出现“提示已发但成员未被踢出”的问题,需要调换两个操作的顺序:

@client.command(aliases=['k'])
@commands.has_permissions(kick_members = True)
async def kick(ctx,member : discord.Member,*,reason= "I do not need a reason"):
    # 先执行踢人操作,成功后再发送提示
    await member.kick(reason=reason)
    await ctx.send(member.name + " 已被踢出服务器,原因:"+reason)

@client.command(aliases=['b'])
@commands.has_permissions(ban_members = True)
async def ban(ctx,member : discord.Member,*,reason= "I do not need a reason"):
    # 先执行封禁操作,成功后再发送提示
    await member.ban(reason=reason)
    await ctx.send(member.name + " 已被封禁服务器,原因:"+reason)

3. 排查特殊拦截场景

  • 确认目标成员不是服务器所有者:Discord规则禁止任何身份(包括机器人)踢出服务器所有者
  • 确认机器人角色没有被单独配置禁止踢人/封禁成员的权限(服务器全局角色权限会被频道级、成员级的单独权限覆盖)

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.17 19:24:01