discord.py中message.mentions校验后else分支无响应问题求解
问题根因
- 核心逻辑误区:discord.py的
message.mentions字段仅收录当前服务器内的有效提及对象。当用户在聊天中@一个不在当前服务器的账号时,这个@不会被Discord识别为有效提及,自然不会被加入message.mentions数组。你代码里的if len(message.mentions) ==1:判断,永远覆盖不到“@了非服务器成员”的场景,这就是else分支完全不触发的根本原因——外层判断根本没进去。 - 代码笔误:else分支中你定义了
embed2变量,实际发送消息时却引用了未定义的embed变量,哪怕能进入分支,这行代码也会直接抛出运行错误,中断后续逻辑。 - 缓存依赖问题:
guild.get_member()完全依赖Bot的本地成员缓存,如果没有开启成员意图、缓存加载不全,哪怕是真实存在的服务器成员,也可能被误判为不在服务器,进一步打乱判断逻辑。
修复方案
- 调整检测逻辑:从消息原始文本中提取所有带<@用户ID>格式的提及内容,和系统自动识别的有效提及列表做差,差值就是“打了@但不在服务器的无效提及”。
- 替换本地缓存判断:把
guild.get_member()换成异步的guild.fetch_member(),直接从Discord接口拉取成员真实状态,避免本地缓存不全导致的误判。 - 修正变量名笔误,匹配实际定义的Embed对象。
- 补全Bot初始化的意图配置,确保能正常读取消息内容、拉取服务器成员信息。
修复后可直接运行的代码
import re import discord from discord.ext import commands # 初始化Bot时必须开启对应权限意图 intents = discord.Intents.default() intents.members = True # 用于获取服务器成员信息 intents.message_content = True # 用于读取原始消息内容做正则匹配 bot = commands.Bot(command_prefix="!", intents=intents) @bot.event async def on_message(message): # 跳过Bot自身发送的消息,避免触发死循环 if message.author.bot: return # 从消息文本中提取所有@提及的用户ID(包含无效@) mentioned_ids = set(re.findall(r'<@!?(\d+)>', message.content)) # 系统识别的有效提及ID(即确实在当前服务器的被@用户) valid_mention_ids = {user.id for user in message.mentions} # 差集即为打了@但不在当前服务器的无效提及 invalid_mention_ids = mentioned_ids - valid_mention_ids # 存在无效提及的分支 if invalid_mention_ids: embed2 = discord.Embed( title="» :warning: | PING not possible", description="你提及的用户不存在于当前服务器,无法发送私信提醒" ) await message.channel.send(content=f"{message.author.mention}", embed=embed2) await message.delete() return # 原有效提及的正常逻辑 if len(message.mentions) == 1: target_user = message.mentions[0] try: # 异步接口拉取二次确认用户确实在服务器,避免缓存误判 await message.guild.fetch_member(target_user.id) await target_user.send(content="You were mentioned in the server chat") except discord.NotFound: # 缓存遗漏的无效提及兜底 embed2 = discord.Embed( title="» :warning: | PING not possible", description="你提及的用户不存在于当前服务器,无法发送私信提醒" ) await message.channel.send(content=f"{message.author.mention}", embed=embed2) await message.delete()
注意事项
- 需要在Discord开发者后台的Bot设置页,手动打开
Server Members Intent和Message Content Intent开关,否则代码中的意图配置不会生效,接口会拒绝相关请求。 - 无效@的形态在Discord里有两种:纯用户ID格式的
<@用户ID>,和带昵称格式的<@!用户ID>,正则已经把两种情况都覆盖了,不需要额外做兼容。
内容的提问来源于stack exchange,提问作者user14766510
相关产品推荐
相关产品推荐

