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
相关产品推荐
相关产品推荐

