Discord.py自角色按钮机器人开发问题求助

问题概述 #

开发Discord.py机器人时，想要实现用户点击按钮即可添加或移除指定角色的功能，但遇到以下问题：

• 机器人的selfrole命令在Discord中完全不显示
• 按钮点击的逻辑存在错误，无法正确执行角色操作

核心需求：

• 正确监听按钮点击事件
• 点击时检查用户当前拥有的角色
• 已拥有目标角色则移除，未拥有则添加

原错误代码 #

import discord
from discord import *

client = discord.Bot()


@client.event
async def on_ready():
    print("connected")

class Selfroles(discord.ui.View):
    def __init__(self) -> None:
        super().__init__(timeout=None)
    
    @discord.ui.button(label="Red", style = discord.ButtonStyle.red, custom_id = "red")
    async def red_role(self, ctx, interaction: discord.Interaction):
        role = discord.utils.get(ctx.guild.roles, name="Red")
        user = ctx.author
        if role in ctx.author.roles: 
            await interaction.user.remove_roles(1144440508383494204)
        else: 
            await interaction.user.add_roles(1144440508383494204)
        

@client.command()
async def selfrole(ctx):
    await ctx.send(view=Selfroles())

client.run(token)

问题点解析 #

1. 命令不显示：使用discord.Bot()默认是slash命令体系，但未同步命令到Discord；同时缺少必要的intents配置，Discord要求开启服务器成员相关intents才能正常使用角色和成员功能。
2. 按钮回调参数错误：Discord.py中按钮回调函数的参数顺序应为self, button, interaction（类方法），原代码错误传入ctx参数，导致回调无法触发。
3. 角色操作参数错误：add_roles()和remove_roles()需要传入discord.Role对象，而非直接传入数字ID，原代码的写法会引发类型错误。
4. 上下文依赖错误：按钮回调中不应依赖初始化时的ctx，因为按钮可能被任意用户点击，正确的做法是通过interaction对象获取当前用户和服务器信息。

修正后的代码 #

import discord
from discord.ext import commands
from discord.ui import View, Button

APP_ID = 12345678910111213  # 替换为你的机器人应用ID
TOKEN = 'ENTER_YOUR_TOKEN_HERE'  # 替换为你的机器人token

class MyBot(commands.Bot):
    def __init__(self):
        # 配置前缀命令、完整intents和应用ID
        super().__init__(command_prefix='!', intents=discord.Intents.all(), application_id=APP_ID)
    
    async def on_ready(self):
        print("BOT is Ready")

bot = MyBot()

class Selfroles(discord.ui.View):
    def __init__(self) -> None:
        super().__init__(timeout=None)
    
    @discord.ui.button(label="Red", style=discord.ButtonStyle.red)
    async def red_role(self, button: discord.ui.Button, interaction: discord.Interaction):
        # 通过interaction获取当前服务器的角色对象
        red_role = discord.utils.get(interaction.guild.roles, name="Red")
        if not red_role:
            await interaction.response.send_message("目标角色不存在！", ephemeral=True)
            return
        
        # 检查用户是否拥有角色，执行添加/移除操作
        if red_role in interaction.user.roles:
            await interaction.user.remove_roles(red_role)
            await interaction.response.send_message("已移除Red角色", ephemeral=True)
        else:
            await interaction.user.add_roles(red_role)
            await interaction.response.send_message("已添加Red角色", ephemeral=True)

@bot.command()
async def selfrole(ctx):
    await ctx.send("点击按钮获取/移除角色：", view=Selfroles())

bot.run(TOKEN, reconnect=True)

关键修改说明 #

• 使用commands.Bot并开启Intents.all()，确保能获取服务器成员和角色的完整数据
• 按钮回调参数修正为正确顺序，通过interaction对象获取当前用户和服务器信息，避免依赖初始化时的上下文
• 角色操作传入discord.Role对象，而非数字ID
• 添加了角色不存在的错误处理，并用ephemeral=True发送仅用户可见的反馈消息

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