discord.py使用slash命令提示Interaction Failed且无报错如何解决？

1. 权限与授权校验 #

• 进入Discord开发者门户的Bot管理页，确认给Bot添加授权链接时，除了基础的Bot权限外，额外勾选了applications.commands权限，缺少该权限会导致命令无法正常响应
• 确认Bot在目标频道拥有发送消息的基础权限，避免消息发送被拦截

2. Slash命令同步配置修正 #

命令描述不显示是因为没有开启命令同步配置，实例化SlashCommand时必须开启同步参数，示例代码如下：

bot = commands.Bot(command_prefix="!", intents=discord.Intents.default())
# sync_commands设为True才会将命令名称、描述同步到Discord服务器
slash = SlashCommand(bot, sync_commands=True)

单服务器测试时可以给命令添加guild_ids参数，指定测试服务器ID，实现命令秒同步，不需要等待全局同步的1小时缓存：

@slash.slash(name="test",
             description="This is just a test command, nothing more.",
             guild_ids=[替换为你的测试服务器ID])
async def _test(ctx: SlashContext): # 必须标注ctx类型为SlashContext
    await ctx.send("Hello World!")

3. 交互超时问题修复 #

触发后显示「Interaction Failed」是因为Discord要求斜杠命令触发后3秒内必须响应交互，你直接调用ctx.channel.send没有完成交互校验，会被Discord判定为响应失败：

• 优先使用ctx.send方法发送消息，该方法会自动完成交互校验，不会触发超时提示
• 如果命令需要处理长时间逻辑，先调用await ctx.defer()延迟响应，最长支持15分钟的后续响应

4. 错误日志排查 #

后台无报错输出可以手动添加异常捕获逻辑，打印具体错误信息：

@slash.slash(name="test",
             description="This is just a test command, nothing more.",
             guild_ids=[替换为你的测试服务器ID])
async def _test(ctx: SlashContext):
    try:
        await ctx.send("Hello World!")
    except Exception as e:
        print(f"命令执行错误：{e}")

5. 依赖版本适配 #

• 旧版第三方discord-py-slash-command库已经停止维护，如果你使用的是discord.py v2.0及以上版本，直接使用官方内置的斜杠命令功能即可，无需引入第三方库
• 确认你当前使用的discord.py版本和discord-py-slash-command版本兼容，版本不兼容也会出现无报错无响应的问题

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