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会触发权限异常,必须加异常捕获,不能因为单个用户接收失败就中断整个通知流程。
- 机器人必须开启成员缓存权限,否则无法获取服务器内的完整成员列表,无法定位需要收通知的角色成员。
实现步骤
- 提前定义所有需要接收通知的角色ID常量:
NOTIFY_TARGET_ROLE_IDS = [ 123456789012345678, # staff角色ID 234567890123456789, # admin角色ID 345678901234567890, # headstaff角色ID 456789012345678901, # 服务器owner角色ID ] - 在自定义的
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 - 把通知方法嵌入你现有的违规检测分支,替换原有的纯打印日志逻辑。比如检测到“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) - 开启成员权限配置,确保能获取完整成员列表:
实例化客户端时同步开启成员意图,否则无法拿到服务器的完整成员缓存:
注意:需要同步在Discord开发者后台的机器人设置页,打开Server Members Intent的权限开关,否则无法正常连接网关。intents = discord.Intents.default() intents.members = True # 把intents参数传入客户端实例 client = MyClient(intents=intents)
现有代码小调整提示
- 原代码里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
相关产品推荐
相关产品推荐

