You need to enable JavaScript to run this app. discord.py自定义角色命令触发NameError: message未定义报错
优惠活动
大模型
产品
解决方案
定价
更多

discord.py自定义角色命令触发NameError: message未定义报错

报错定位与修复方案

核心报错触发原因

当前抛出的NameError: name 'message' is not defined来自代码中未定义的变量引用:

  • discord.py带@bot.command装饰器的命令函数,只会接收一个上下文对象ctx作为传入参数,不存在可以全局直接调用的message变量。你代码里写的discord.utils.get(message.guild.roles, ...)这行,因为根本找不到叫message的变量,直接触发报错。
  • 取当前命令所在服务器的角色列表,正确的路径是从上下文对象获取:用ctx.guild.roles即可,等价于你本来想写的ctx.message.guild.roles,完全不需要绕一层未定义的message变量。

隐藏的配套Bug(修完NameError就会立刻踩的坑)

就算你把message改成ctx.message,后续代码还是会跑不通,需要一起修正:

  • 你写的匹配参数name = '784837948134785055'是错的,这个数值是Discord的角色ID,不是角色名称。用discord.utils.get按name属性匹配根本找不到对应角色,正确的角色获取方式是直接用ctx.guild.get_role(角色ID),效率更高也不会因为角色改名失效。
  • discord.py 2.0+版本已经废弃了member.add_role()方法,替换为member.add_roles();而且这个方法是异步协程,必须加await关键字调用,否则只会输出协程对象的警告,完全不会执行加角色的操作。
  • 你当前的分支逻辑只写了Feu这一个元素的处理,剩下四个随机抽到的元素没有对应的角色匹配、提示语逻辑,抽中非Feu选项的时候会直接无响应。

修正后的可运行代码

@bot.command()
async def gen_element(ctx):
    # 提前定义元素和对应角色ID的映射表
    element_role_map = {
        'Feu': '这里替换成你火元素角色的真实ID',
        'Eau': '这里替换成你水元素角色的真实ID',
        'Terre': '这里替换成你土元素角色的真实ID',
        'Vent': '这里替换成你风元素角色的真实ID',
        'Foudre': '这里替换成你雷元素角色的真实ID'
    }
    element_reply_map = {
        'Feu': "Vous avez débloqué l'élément feu 🔥 !",
        'Eau': "Vous avez débloqué l'élément eau 💧 !",
        'Terre': "Vous avez débloqué l'élément terre 🪨 !",
        'Vent': "Vous avez débloqué l'élément vent 🌪️ !",
        'Foudre': "Vous avez débloqué l'élément foudre ⚡ !"
    }
    # 过滤私信场景下的无效触发
    if not ctx.guild:
        await ctx.send("该命令仅可在服务器频道内使用")
        return
    choice = random.choice(list(element_role_map.keys()))
    target_role = ctx.guild.get_role(element_role_map[choice])
    # 校验角色是否存在,避免空值报错
    if not target_role:
        await ctx.send("配置异常:未找到对应元素的角色,请联系服务器管理员检查")
        return
    # 给触发成员添加对应角色
    await ctx.author.add_roles(target_role, reason="随机抽取元素成功")
    await ctx.send(element_reply_map[choice])

内容的提问来源于stack exchange,提问作者NilouLeLoup

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 07:36:04