Py-Cord权限访问时命令无响应问题求助

问题复现 #

执行staffrole命令后，第一个print语句正常输出，但第二个print无输出，程序无报错；在自己的测试服务器可正常运行，但在非本人拥有的服务器中失效。目标服务器中机器人拥有Manage Server权限，但无Administrator权限。

核心原因 #

当机器人没有Administrator权限时，直接访问ctx.author.guild_permissions可能因为缓存不完整或权限不足导致代码静默阻塞：

• 非测试服务器中，机器人的用户缓存可能未同步最新的成员权限信息，访问guild_permissions时触发隐式的缓存刷新操作，但因权限限制卡住；
• 机器人缺少Manage Roles权限时，无法读取用户的服务器级权限属性，导致操作无响应且不抛出异常。

解决方案 #

1. 强制获取最新成员对象：通过fetch_member获取服务器中最新的用户数据，避免缓存问题；
2. 添加异常捕获：捕获潜在异常以便排查问题；
3. 验证机器人权限：在目标服务器中为机器人授予Manage Roles权限（若无法授予Administrator）。

修正后的代码示例 #

@admin.command(name="staffrole", description="Toggle a role that has permissions to use this bot's admin commands")
@guild_only()
async def staffrole(ctx, role: discord.Option(Union[discord.Role])):
    print('This prints successfully')
    try:
        # 获取最新的成员对象，避免缓存过期或不完整
        member = await ctx.guild.fetch_member(ctx.author.id)
        admin = member.guild_permissions.administrator or member.guild_permissions.manage_server
        print("This should print now.")
        
        if not admin:
            return await ctx.respond("You must have \"Manage Server\" or \"Administrator\" permission in this server to use this.", ephemeral=True)
            
        # 原有文件操作逻辑保持不变
        try:
            with open(f"StaffRoles/{ctx.guild.id}", 'x') as _:
                pass
        except FileExistsError:
            pass
            
        with open(f"StaffRoles/{ctx.guild.id}", 'r') as file:
            filedata = file.readlines()
            if f"{role.id}\n" in filedata:
                with open(f'StaffRoles/{ctx.guild.id}', 'w') as filew:
                    filedata = ''.join(filedata)
                    filedata = filedata.replace(f'{str(role.id)}\n', '')
                    filew.write(filedata)
                await ctx.respond(f"Removed {str(role)} from the Staff List!", ephemeral=True)
            else:
                with open(f"StaffRoles/{ctx.guild.id}", 'a') as filea:
                    filea.write(f"{str(role.id)}\n")
                await ctx.respond(f"Added {str(role)} to the Staff List!", ephemeral=True)
                
    except Exception as e:
        print(f"Error occurred: {e}")
        await ctx.respond("An error occurred while processing your request.", ephemeral=True)

额外建议 #

• 再次验证机器人已启用Server Members Intent；
• 涉及权限检查时优先使用fetch_member获取实时数据，避免依赖缓存；
• 确保机器人拥有Manage Roles权限，这是读取用户服务器级权限的必要条件（无Administrator权限时）。

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