You need to enable JavaScript to run this app. discord.py中message.mentions校验后else分支无响应问题求解
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.08 06:15:05