使用Pycord Cogs添加Persistent Views时遇403 Forbidden错误求助

我尝试用Pycord的Cogs实现持久化视图，但运行时触发错误：Pycord | discord.errors.Forbidden: 403 Forbidden (error code: 50001): Missing Access。我已经给机器人分配了应用命令权限并重新邀请，但问题仍未解决，且其他Cogs也无法正常工作。

扩展代码 #

import discord
from discord.ext import commands

"""
让用户通过点击按钮自行分配角色。
视图为持久化类型，机器人重启后仍能正常工作。
"""

# 要添加为按钮的角色ID列表
role_ids = [1066139205060804679,1066139281518755941,1066139307951271996,1066139330063634503]


class RoleButton(discord.ui.Button):
    def __init__(self, role: discord.Role):
        """单个角色对应的按钮，持久化视图必须设置custom_id"""
        super().__init__(
            label=role.name,
            style=discord.ButtonStyle.primary,
            custom_id=str(role.id),
        )

    async def callback(self, interaction: discord.Interaction):
        """用户点击按钮时触发此函数
        参数
        ----------
        interaction: :class:`discord.Interaction`
            用户点击按钮时生成的交互对象
        """
        # 获取点击按钮的用户
        user = interaction.user
        # 通过custom_id获取按钮对应的角色
        role = interaction.guild.get_role(int(self.custom_id))

        if role is None:
            # 角色不存在时直接返回，可在此添加错误处理逻辑
            return

        # 给用户添加/移除角色，并发送仅用户可见的回应
        if role not in user.roles:
            await user.add_roles(role)
            await interaction.response.send_message(
                f"🎉 已为你分配角色 {role.mention}!",
                ephemeral=True,
            )
        else:
            await user.remove_roles(role)
            await interaction.response.send_message(
                f"❌ 已为你移除角色 {role.mention}!",
                ephemeral=True,
            )


class ButtonRoleCog(commands.Cog):
    """
    包含一个Slash命令用于发布带按钮的消息，
    并在机器人重启时重新初始化持久化视图的Cog
    """

    def __init__(self, bot):
        self.bot = bot

    # 传入服务器ID列表限制命令使用范围
    @commands.slash_command(guild_ids=role_ids, description="发布角色按钮消息")
    async def post(self, ctx: discord.ApplicationContext):
        """发布带角色按钮的持久化视图消息"""

        # timeout设为None以启用持久化
        view = discord.ui.View(timeout=None)

        # 遍历角色列表，为每个角色添加按钮到视图
        for role_id in role_ids:
            role = ctx.guild.get_role(role_id)
            view.add_item(RoleButton(role))

        await ctx.respond("点击按钮分配/移除角色", view=view)

    @commands.Cog.listener()
    async def on_ready(self):
        """机器人重启时重新加载持久化视图"""
        view = discord.ui.View(timeout=None)
        # 指定按钮生效的服务器ID
        guild = self.bot.get_guild(1063291660496293928)
        for role_id in role_ids:
            role = guild.get_role(role_id)
            view.add_item(RoleButton(role))

        # 将视图添加到机器人，开始监听按钮交互
        self.bot.add_view(view)


def setup(bot):
    bot.add_cog(ButtonRoleCog(bot))

Intents配置及扩展调用方式 #

intents = discord.Intents.default()
intents.members = True
intents.message_content = True
bot = discord.Bot(intents=intents)
bot.load_extension('cogs.roles')
bot.run(TOKEN)

问题排查与解决建议 #

1. 修复核心参数错误 #

你的@commands.slash_command装饰器中，guild_ids=role_ids是致命错误——guild_ids需要传入服务器ID列表，但你传入的是角色ID列表，导致命令无法正确注册，触发权限异常。

修改为目标服务器ID：

@commands.slash_command(guild_ids=[1063291660496293928], description="发布角色按钮消息")

2. 机器人权限检查 #

• 确保机器人角色在服务器角色列表中高于所有要分配的角色，否则无法添加/移除这些角色。
• 重新邀请机器人时，勾选applications.commands、Manage Roles、Send Messages、Embed Links等必要权限。
• 检查服务器是否开启“服务器设置 → 机器人 → 要求令牌认证”，确保机器人令牌正确无误。

3. 持久化视图初始化验证 #

• 确认on_ready中指定的服务器ID正确，且机器人未被该服务器踢出。
• 机器人重启时必须重新加载视图，否则之前的持久化按钮会失效。

4. 其他Cogs异常排查 #

如果其他Cogs也无法工作，可能是：

• 某个Cogs存在语法错误或未处理的异常，导致加载流程中断，可尝试逐个加载Cogs定位问题。
• 机器人缺少Send Messages等基础权限，导致所有交互功能失效。

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