本文详解如何使用 discord.py 实现消息删除与编辑的完整日志记录功能，包括自动捕获被删消息内容、编辑前后的文本对比，并统一发送至指定日志频道，适用于服务器管理类 bot 开发。
本文详解如何使用 discord.py 实现消息删除与编辑的完整日志记录功能，包括自动捕获被删消息内容、编辑前后的文本对比，并统一发送至指定日志频道，适用于服务器管理类 bot 开发。
要构建一个可靠的服务器日志系统，关键在于准确捕获 on_message_delete 和 on_message_edit 两个事件，并以清晰、可读的方式呈现变更信息。你已成功实现删除日志，接下来只需补全编辑日志逻辑——核心在于理解 on_message_edit 的双参数签名：before 表示编辑前的消息对象，after 表示编辑后的新状态。
以下是整合优化后的完整实现（兼容 Cog 结构）：
宝塔Linux面板11.5.0
下载
宝塔面板11.5.0版本作为当前主流的稳定版，集成了最新的安全策略与性能优化功能。我为你撰写了以下SEO配置方案，重点突出了“高效运维”与“安全防护”两大核心价值：
@commands.Cog.listener()
async def on_message_delete(self, message: discord.Message):
# 忽略系统消息、空内容或无权限访问的私有频道
if not message.content and not message.attachments:
return
embed = discord.Embed(
title="?️ Message Deleted",
color=0xff4d4d,
timestamp=message.created_at
)
embed.add_field(name="Author", value=message.author.mention, inline=False)
embed.add_field(name="Channel", value=message.channel.mention, inline=False)
embed.add_field(name="Content", value=message.content or "[No text content]", inline=False)
# 尝试获取日志频道（推荐使用 ID 替代名称查找，更稳定）
log_channel = discord.utils.get(message.guild.channels, name="logging")
if log_channel:
await log_channel.send(embed=embed)
@commands.Cog.listener()
async def on_message_edit(self, before: discord.Message, after: discord.Message):
# 忽略自身编辑、系统消息、内容未实际变更的情况
if before.author.bot or before.content == after.content:
return
embed = discord.Embed(
title="✏️ Message Edited",
color=0x4da6ff,
timestamp=after.edited_at or after.created_at
)
embed.add_field(name="Author", value=before.author.mention, inline=False)
embed.add_field(name="Channel", value=before.channel.mention, inline=False)
embed.add_field(name="Before", value=before.content[:1024] or "[Empty]", inline=False)
embed.add_field(name="After", value=after.content[:1024] or "[Empty]", inline=False)
# 若内容过长，添加省略提示
if len(before.content) > 1024:
embed.add_field(name="Before (truncated)", value=f"`{before.content[:1020]}...`", inline=False)
if len(after.content) > 1024:
embed.add_field(name="After (truncated)", value=f"`{after.content[:1020]}...`", inline=False)
log_channel = discord.utils.get(before.guild.channels, name="logging")
if log_channel:
await log_channel.send(embed=embed)
✅ 关键注意事项：
- on_message_edit 必须接收两个参数（before, after），缺一不可；若只写一个参数会报错或静默失败；
- 建议用 message.guild.id + channel_id 静态配置日志频道（而非依赖频道名），避免重命名导致查找失败；
- 添加 before.author.bot 判断可过滤掉其他 Bot 的编辑日志，减少干扰；
- 使用 [:1024] 截断长文本是 Discord Embed 字段长度限制（1024 字符）的必要处理；
- edited_at 可能为 None（如快速编辑未触发时间戳更新），需回退至 created_at 保证时间显示不为空。
最后，确保你的 Bot 拥有对应频道的 Send Messages 和 Embed Links 权限，并已在 intents 中启用 MessageContentIntent（v2.0+ 版本必需）。完成部署后，所有用户的消息删除与编辑行为将实时、结构化地归档至日志频道，为服务器治理提供坚实审计依据。
