discord.py搭配DiscordComponents开发bot按钮交互失败问题咨询

问题背景 #

• 开发需求：为Discord机器人实现消息按钮用户交互功能，初始技术选型为discord.py搭配第三方库discord_components
• 故障现象：按钮可正常创建并展示，但点击后始终弹出This interaction failed报错，无法捕获按钮点击输入
• 报错截图：
  
• 初始测试代码：

import discord
from discord_components import DiscordComponents, ComponentsBot, Button, SelectOption, Select
import discord.ext.commands as commands

bot = commands.Bot("!", intents = discord.Intents.all())
ComponentsBot(bot)

@bot.command()
async def hello(ctx):
    await ctx.send("hello", components = [
        [Button(label="Hi", style="3", emoji = "🥴", custom_id="button1")]
        ])
    interaction = await bot.wait_for("button_click")
    await interaction.send(content = "Button clicked!", ephemeral=False)
    

bot.run('user_token (hidden for privacy)')

• 选型限制：不希望重构现有基于commands.Bot对象的代码，需要保留!前缀传统命令，不希望切换到基于Client对象的斜杠命令专用库（如已测试可用的interactions.py）

问题根因 #

1. 核心原因：discord_components库早已停止维护，完全不适配当前Discord API的交互校验、响应时效规则，无法正常处理按钮点击事件
2. 代码逻辑缺陷：原代码的wait_for未设置交互校验规则、未做3秒内响应的ACK处理，即使库可用也会出现交互冲突、超时失败的问题

最优解决方案 #

直接升级到**2.0及以上版本的discord.py**即可，该版本已原生支持按钮、下拉菜单等所有交互组件，无需引入任何第三方组件库，完美兼容现有commands.Bot对象和!前缀命令逻辑，零重构成本。

可直接运行的实现代码 #

方式1：类式绑定（推荐，按钮长期有效）

import discord
from discord.ext import commands

# 依赖安装命令：pip install discord.py>=2.3.0
bot = commands.Bot(command_prefix="!", intents=discord.Intents.all())

# 自定义按钮组件视图
class HiButton(discord.ui.View):
    def __init__(self):
        # timeout=None 设置按钮永久有效，默认值180为180秒后自动失效
        super().__init__(timeout=None)

    @discord.ui.button(label="Hi", style=discord.ButtonStyle.green, emoji="🥴", custom_id="button1")
    async def hi_btn_click(self, interaction: discord.Interaction, button: discord.ui.Button):
        # Discord要求所有交互必须在3秒内返回响应，否则直接判定失败
        await interaction.response.send_message(content="Button clicked!", ephemeral=False)

@bot.command()
async def hello(ctx):
    await ctx.send("hello", view=HiButton())

bot.run("你的机器人私有Token")

方式2：wait_for 捕获（适配原有代码逻辑）

如果需要保留原代码中wait_for的事件捕获写法，可使用如下实现：

@bot.command()
async def hello(ctx):
    view = discord.ui.View(timeout=60)
    hi_btn = discord.ui.Button(label="Hi", style=discord.ButtonStyle.green, emoji="🥴", custom_id="button1")
    view.add_item(hi_btn)
    msg = await ctx.send("hello", view=view)

    # 校验规则：仅响应当前消息上、对应custom_id的按钮点击
    def interaction_check(interaction: discord.Interaction):
        return interaction.message.id == msg.id and interaction.custom_id == "button1"

    try:
        interaction = await bot.wait_for("interaction", check=interaction_check, timeout=60)
        await interaction.response.send_message(content="Button clicked!", ephemeral=False)
    except TimeoutError:
        # 超时后禁用按钮
        hi_btn.disabled = True
        await msg.edit(view=view)

注意事项 #

• 安装依赖时必须卸载旧版1.x版本的discord.py和废弃的discord_components，避免版本冲突
• 所有按钮、菜单交互必须在触发后3秒内调用interaction.response的对应方法完成响应，否则必然出现交互失败报错
• 原生组件支持所有按钮样式、链接跳转、权限校验等功能，完全覆盖第三方组件库的所有能力，且随官方库长期维护，不存在停更风险

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