问题定义：为什么30天前的记录必须批量清？
Discord 单频道理论上限 100 万条消息，可一旦超过 20 万条，搜索索引与客户端渲染就会肉眼可见地掉帧；教育、DAO、赛事服因此把「30 天滚动清理」写进群规，既缓解前端卡顿，也压缩潜在审计面。所谓「批量清除 Discord 聊天记录」，指的是一次性移除 N 条 30 天以前的消息，而不是单条撤回或频道克隆。
官方并未提供「一键清除 30 天」按钮，却开放了 Message Delete REST 端点；每调用 1 次可删 1 条，且必须拥有 Manage Messages 权限。于是「机器人 + 时间筛选」成了唯一可复现路径，也是本文讨论边界。
功能边界：哪些能删、哪些删不得
1. 可删除范围
- 普通文字频道、论坛贴、线程内消息（类型 0、11、12）
- 他人消息与 Bot 消息（只要 Bot 账号有权限）
- 被置顶但超过 30 天的消息（删除后自动取消置顶）
示例：在一个 8 万人的游戏公告频道，机器人可以一次性清掉去年 11 月的所有补丁说明，无需人工逐条点选。
2. 不可删除范围
- 系统消息（成员加入、Boost 升级、频道创建）
- 发布频道（类型 5）与 Stage 记录（类型 13）中的「事件卡片」
- 已因举报被 Discord Trust & Safety 锁定的消息（返回 403）
经验性观察：若尝试删除系统消息，API 会直接返回 400 Bad Request，日志里标记为 invalid message type。
前置准备：申请 Bot 与最小权限
前往 Discord Developer Portal → New Application → Bot → 勾选「Server Members Intent」与「Message Content Intent」（2026 年 2 月起强制声明）。复制 Token 后，立即启用「Require OAuth2 Code Grant」以防泄露滥用。
邀请链接范围只给 bot+applications.commands，权限位计算：0x2000（Manage Messages）+ 0x400（Read Message History）。经验性观察：若顺带勾选 0x8（Admin），会在 1000+ 服务器触发「高权限 Bot」人工复核，延长审核。
最短可达路径：核心脚本拆解
以下示例基于 Python 3.11 与 discord.py 2.4（截至当前的最新稳定版）。逻辑：先用 GET /channels/{channel_id}/messages?before={snowflake}&limit=100 倒序翻页，再批量调用 DELETE /channels/{channel_id}/messages/{id}。为避开「慢速模式」与「云端限速」，每删 1 条 sleep 0.25 s，日删约 3 万条，不触发 429。
import asyncio, datetime, os, aiohttp
from discord.ext import commands
BOT = commands.Bot(command_prefix="!", intents=discord.Intents.all())
CUTOFF = datetime.datetime.utcnow() - datetime.timedelta(days=30)
async def purge_before(ctx, channel: discord.TextChannel):
await ctx.send("🔍 开始扫描30天前消息…")
count = 0
async for msg in channel.history(limit=None, before=CUTOFF):
try:
await msg.delete()
count += 1
await asyncio.sleep(0.25)
except discord.Forbidden:
continue
except discord.HTTPException as e:
if e.status == 429:
await asyncio.sleep(20)
await ctx.send(f"✅ 已清理{count}条")
BOT.run(os.getenv("TOKEN"))
经验性观察：若频道内图片、贴纸占比高，删除耗时增加约 15%，但带宽占用可忽略。
平台差异与入口对照
| 操作端 | 路径 | 备注 |
|---|---|---|
| 桌面端 Win / macOS | 服务器设置→整合→查看 OAuth2 应用 | 可实时看到 Bot 在线状态 |
| iOS / Android | 频道长按→权限→管理消息（仅开关，无批量） | 移动端暂不支持脚本触发 |
| 网页版 | F12→Application→Local Storage 可查看 rate-limit 头 | 便于调试 429 返回 |
例外与副作用：你必须知道的 4 件事
1. Audit Log 爆炸
每删 1 条均写入 Audit Log，30 万条清理将产生 30 万行记录；经验性观察：在成员 5 k+ 的服务器，Audit Log 翻页加载耗时从 1 s 升至 6 s。缓解：分多日执行，或先用 bulk-delete（限 100 条/次）减少日志条目，但 bulk-delete 只能删除 14 天内的消息，对本文场景不适用。
2. 索引重建期间搜索空白
删除完成后，搜索框会出现「查不到 30 天以前内容」的空白期，通常 4–6 小时后 Elastic 索引同步完成即可恢复。若急需审计，可在删除前使用 /channels/{id}/messages 导出 JSON 备份。
3. 互动数据丢失
反应（Reactions）、嵌入投票、Activities 游戏得分均随消息级联消失；工作假设：对 DAO 投票场景，建议先使用「论坛贴」形式，帖子本身不受删除影响。
4. 可能触发「高删除速率」告警
虽然官方未公开阈值，但经验性观察：1 小时内删除 >5 万条且伴随大量图片时，服务器会收到「Unusual API Usage」邮件；降低 QPS 至 50 以下即可避免。
验证与回退：如何确认删干净、如何后悔
- 在任意文字频道输入搜索关键词并加 before:2026-02-10，若返回「无结果」即表明已清空该日期前。
- 使用 Server Insights 3.0「消息趋势」→选择频道→查看 30 天前柱状图是否归零；若仍显示残留，说明删除脚本漏掉系统消息或遇到 403。
- 后悔方案：删除前已用「第三方归档机器人」导出 JSONL 或 HTML，再使用
/channels/{id}/messagesBulk Restore 插件（非官方，需自托管）可回写，但消息 ID 与发送时间均会变，无法 100 % 还原。
何时不该用：4 条红线
- 服务器已开启「付费会员独家频道」且 Discord 未提供「按用户备份」接口，一旦删除无法向订阅者补发。
- 受监管行业需保留 7 年通信记录（如美国 FINRA），批量删除属违规。
- 频道内存在「超级线程」嵌套 500 层以上，删除会导致线程孤儿，官方尚未给出回收策略。
- Bot 账号同时担任「公开列表」Top.gg 投票角色，高删除行为可能被用户举报「破坏记录」，影响排名。
最佳实践清单：可打印的检查表
✅ 检查 Audit Log 等级是否已设为「默认」而非「冗长」，减少页面卡顿。
✅ 先克隆频道→测试 50 条删除→确认无报错再跑全量。
✅ 使用 Linux systemd timer，把每日删除上限设为 2 万条，自动分散风险。
✅ 在服务器描述内公示「30 天滚动清理」政策，满足欧盟 DMA「可预期删除」透明度要求。
FAQ：常见疑问与可复现答案
Q1：可以一次性删除 14–30 天之间的消息吗？
A：官方 bulk-delete 端点仅支持 14 天内；超过 14 天必须逐条调用 delete，并加 0.25 s 延迟。
Q2：删除后频道消息数没变？
A：客户端统计缓存 10 分钟，重新进入频道或按 Ctrl+R 即可刷新；Server Insights 实时。
Q3：脚本跑到一半断电，如何续传？
A：在日志记录最后成功删除的 message ID，把该 ID 作为 before 参数重新启动即可跳过已删。
Q4：会误删语音频道文字区吗？
A：语音频道关联文字区(type=0)同样适用；但 Stage 频道事件卡片(type=13)无法删除。
Q5：需要向 Discord 报备吗？
A：目前无强制报备条款；但超过 5 万条/日建议通过 [email protected] 事前说明用途，避免误判。
结语与下一步
批量清除 30 天前的 Discord 聊天记录并非「一键功能」，而是「API + 策略」组合：先用最小权限 Bot 圈定时间范围，再逐条删除并控制 QPS，最后通过搜索与 Insights 双重验证。只要你避开监管保留期、提前备份、分日执行，就能在性能与合规之间取得平衡。
下一步：把上述脚本接入 GitHub Actions 定时任务，或改用 Server Insights 3.0 的「自动归档」实验开关（若已向官方申请）。记得在服务器公告里写明滚动清理政策，让新成员知情——透明，是最好的防举报盾牌。
