Discord机器人自动创建角色时无报错但程序冻结问题排查

以下是可能的原因及对应解决方法：

• 机器人权限不足
  创建角色需要机器人拥有「管理角色」权限，且机器人的角色位置必须高于要创建的角色（Discord角色权限按列表位置排序，低位置角色无法管理高位置角色）。即便命令要求管理员权限，若机器人自身权限不达标，create_role请求会被Discord API静默拦截，导致请求挂起。
  解决：在服务器「角色」设置面板中，将机器人角色移至所有角色上方，并确保开启「管理角色」权限。

• 触发Discord API速率限制
  你的代码通过嵌套循环批量创建角色，短时间内发起大量create_role请求会触发Discord的API速率限制（Rate Limits）。此时机器人会等待限流解除，但因无超时处理，程序会表现为「冻结」。
  解决：在循环中添加短暂延迟，比如每次创建角色后执行await asyncio.sleep(1)，控制请求频率避免触发限流。

• on_ready方法中的错误引用
  Bot类的on_ready方法里使用了bot.user，但此时bot变量尚未完成初始化（bot = Bot()定义在类之后），应使用self.user引用当前机器人实例。虽不一定直接导致角色创建失败，但会引发潜在初始化问题。
  修改：将print(f'We have logged in as {bot.user}')改为print(f'We have logged in as {self.user}')。

• 缺少必要的Intents配置
  虽然你开启了message_content intent，但服务器角色操作依赖的guilds或members intent若未在Discord开发者后台开启，也会导致操作失败。
  解决：登录Discord开发者后台，确认应用已开启「Server Members Intent」和「Guilds Intent」。

修改后的示例代码片段（添加限流延迟） #

import asyncio

async def createRole(guild, countries, citys):
    lst_1 = []
    lst_2 = []
    lst_code = []
    lst_combinded = []
    for i, country in enumerate(countries, 1):
        for j, city in enumerate(citys, 1):
            code = f"{i:03d}{j:02d}"
            print(code)
            lst_1.append(country)
            lst_2.append(city)
            lst_code.append(code)
            lst_combinded.append(f"{country.lower()}_{city.lower()}")
            print(lst_combinded)

            role_object = discord.utils.get(guild.roles, name=code)
            if role_object is None:
                print("here1")
                await guild.create_role(name=str(code), colour=discord.Colour(0xffffff))
                print("here2")
                # 添加延迟避免触发API限流
                await asyncio.sleep(1)

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