You need to enable JavaScript to run this app. Discord.py 如何检测作者角色并向指定角色发私信?
优惠活动
大模型
产品
解决方案
定价
更多

Discord.py 如何检测作者角色并向指定角色发私信?

报错根因与前置避坑
  • 你遇到的member has no attribute 'server_privileges' 报错,本质是调用了discord.py 0.x版本已完全废弃的API,当前主流的1.x、2.x版本均已移除该属性,无法通过该方法获取成员权限。
  • 高频触发同类报错的场景:message.author 只有在服务器频道内发消息时,才会返回带角色、权限属性的discord.Member对象;如果是私人频道发来的消息,返回的是无服务器相关属性的discord.User,直接取角色属性必然报错。
1. 正确检测消息作者的所属角色/权限

所有角色、权限检测仅在服务器频道消息中执行,跳过DM渠道消息,从根源避免属性报错。

按权限检测(匹配你原本想调用server_privileges("kick_members")的场景)

替换原有废弃API调用,直接使用成员内置的权限位判断:

# 在on_message方法开头加前置判断,跳过DM消息
if message.guild is None:
    return
# 直接读取成员在当前服务器的权限集
author_perms = message.author.guild_permissions
# 判断是否拥有踢人权限,替代原server_privileges调用
if author_perms.kick_members:
    # 执行对应分支逻辑

按指定角色检测(匹配你代码里“识别特殊角色、调整垃圾检测阈值”的占位逻辑)

推荐使用角色ID做匹配,避免后续修改角色名导致逻辑失效:

# 提前定义常量,把服务器内需要特殊处理的角色ID填入
SPECIAL_TREATMENT_ROLE_ID = 123456789012345678
if message.guild is None:
    return
# 遍历作者的全部角色,判断是否匹配目标角色ID
author_has_special_role = any(role.id == SPECIAL_TREATMENT_ROLE_ID for role in message.author.roles)
if author_has_special_role:
    # 走高阈值垃圾检测分支(对应你代码里1e17阈值的逻辑)
2. 向指定角色全体成员发送DM通知

需要提前处理两个平台规则限制,避免程序中断:

  • 成员如果关闭了“接收服务器机器人私信”的设置,发DM会触发权限异常,必须加异常捕获,不能因为单个用户接收失败就中断整个通知流程。
  • 机器人必须开启成员缓存权限,否则无法获取服务器内的完整成员列表,无法定位需要收通知的角色成员。

实现步骤

  1. 提前定义所有需要接收通知的角色ID常量:
    NOTIFY_TARGET_ROLE_IDS = [
        123456789012345678, # staff角色ID
        234567890123456789, # admin角色ID
        345678901234567890, # headstaff角色ID
        456789012345678901, # 服务器owner角色ID
    ]
    
  2. 在自定义的MyClient类里新增通用通知方法:
    async def send_staff_notification(self, report_content: str, message: discord.Message):
        # 跳过非服务器来源的消息
        if message.guild is None:
            return
        # 遍历服务器所有成员,筛选出带目标通知角色的对象
        for member in message.guild.members:
            # 跳过所有机器人账号
            if member.bot:
                continue
            # 判断成员是否持有任意一个需要接收通知的角色
            is_target_member = any(role.id in NOTIFY_TARGET_ROLE_IDS for role in member.roles)
            if not is_target_member:
                continue
            # 尝试发送私信,加异常捕获跳过关闭DM权限的成员
            try:
                await member.send(f"【社区违规通知】\n{report_content}")
            except discord.Forbidden:
                continue
    
  3. 把通知方法嵌入你现有的违规检测分支,替换原有的纯打印日志逻辑。比如检测到“Being sus”违规时,在打印完报告内容后调用通知:
    if CheckBot.susCheck(self, message.content, susWords):
        reasons.append("Being sus")
        report = "Caught " + str(message.author) + " being sus with the following message: \n" + message.content
        print("")
        print("####################-END-####################")
        print("")
        print(report)
        # 触发 staff 通知
        await self.send_staff_notification(report, message)
    
  4. 开启成员权限配置,确保能获取完整成员列表:
    实例化客户端时同步开启成员意图,否则无法拿到服务器的完整成员缓存:
    intents = discord.Intents.default()
    intents.members = True
    # 把intents参数传入客户端实例
    client = MyClient(intents=intents)
    
    注意:需要同步在Discord开发者后台的机器人设置页,打开Server Members Intent的权限开关,否则无法正常连接网关。

现有代码小调整提示

  • 原代码里spam检测分支的report字符串拼接缺少空格:"Caught " + str(message.author) + "spamming with the following message: \n" + message.content 中author和spamming之间缺少空格,会导致通知内容出现粘连,调整为"Caught " + str(message.author) + " spamming with the following message: \n" + message.content即可。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.05 15:24:06