Discord.py rewrite版kick/ban命令无响应问题修复求助

问题成因 #

• Discord API v10及以上版本强制要求读取消息内容的权限，你未在开发者后台开启Message Content Intent，也未在代码中声明对应意图，导致前缀命令无法被识别触发。
• 机器人账号未被分配服务器的踢出成员/封禁成员权限，或机器人的角色等级低于要操作的成员角色等级，权限校验不通过无法执行操作。
• 命令前缀设置不匹配，你发送命令时未带上预设的命令前缀，导致命令无法被触发。
• 未添加错误处理逻辑，命令执行时抛出的异常仅输出在控制台，没有频道消息反馈，会让你误以为命令没有运行。

修复步骤 #

1. 调整代码初始化配置，开启必要意图 #

确保你初始化客户端的代码开启了消息内容读取意图，且配置了正确的命令前缀，示例如下：

import discord
from discord.ext import commands

# 声明所需网关意图
intents = discord.Intents.default()
intents.message_content = True # 必须开启，否则无法读取前缀命令的消息内容

# 初始化客户端，这里command_prefix的值替换为你自己想要的前缀，示例用!作为前缀
client = commands.Bot(command_prefix='!', intents=intents)

2. 优化命令代码，添加权限校验和错误反馈 #

给原有命令添加权限校验逻辑和执行反馈，同时增加全局错误处理方便排查问题，优化后代码如下：

@client.command()
# 校验调用命令的用户自身是否有踢人权限
@commands.has_permissions(kick_members=True)
async def kick(ctx, member: discord.Member,*,reason=None):
    # 校验机器人自身是否有踢人权限
    if not ctx.guild.me.guild_permissions.kick_members:
        await ctx.send("我没有踢出成员的权限，无法执行操作")
        return
    # 校验要操作的成员权限是否高于机器人
    if member.top_role >= ctx.guild.me.top_role:
        await ctx.send("我无法操作权限等级高于或等于我的成员")
        return
    await member.kick(reason=reason)
    await ctx.send(f"已成功踢出 {member.mention}，原因：{reason if reason else '无'}")

@client.command()
# 校验调用命令的用户自身是否有封禁权限
@commands.has_permissions(ban_members=True)
async def ban(ctx, member: discord.Member,*,reason=None):
    # 校验机器人自身是否有封禁权限
    if not ctx.guild.me.guild_permissions.ban_members:
        await ctx.send("我没有封禁成员的权限，无法执行操作")
        return
    # 校验要操作的成员权限是否高于机器人
    if member.top_role >= ctx.guild.me.top_role:
        await ctx.send("我无法操作权限等级高于或等于我的成员")
        return
    await member.ban(reason=reason)
    await ctx.send(f"已成功封禁 {member.mention}，原因：{reason if reason else '无'}")

# 全局命令错误处理，覆盖常见报错场景
@client.event
async def on_command_error(ctx, error):
    if isinstance(error, commands.MissingPermissions):
        await ctx.send("你没有执行该命令的权限")
    elif isinstance(error, commands.MissingRequiredArgument):
        await ctx.send("命令参数不完整，请指定要操作的成员")
    elif isinstance(error, commands.MemberNotFound):
        await ctx.send("未找到对应的成员")
    else:
        # 其余异常打印到控制台方便定位问题
        print(error)

3. 检查Discord开发者后台和服务器权限设置 #

• 进入Discord开发者平台的机器人应用页，找到「Bot」设置板块的Privileged Gateway Intents分区，开启Message Content Intent开关。
• 邀请机器人进入服务器时，勾选Kick Members和Ban Members权限；如果已经邀请，可进入服务器的角色设置，给机器人对应的角色分配这两个权限，同时将机器人的角色拖拽到所有你需要操作的普通成员角色的上方。

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