直接用 delete_many() 配合自定义时间字段（如 expires_at）删除过期文档比 TTL 索引更可控，需统一使用 UTC 时间、确认字段为 ISODate 类型、先测试再执行，并通过分批限速避免阻塞；TTL 索引不支持动态过期逻辑、复合条件及嵌套结构，且延迟不可控、无法审计。
用 delete_many() 配合时间条件删除过期文档
直接删比定时任务更可控，也避免写错 TTL 索引导致误删。关键不是“怎么删”，而是“按什么时间字段判断过期”——MongoDB 本身不维护逻辑过期时间，得靠你自己的字段（比如 created_at、updated_at 或 expires_at）。
常见错误是拿 datetime.utcnow() 直接减去 timedelta 比较，却忘了数据库里存的是带时区还是无时区时间。如果 Python 写入时用的是 datetime.now()（本地时区），而查询时用 datetime.utcnow()（UTC），就会漏删或误删。
- 统一用 UTC 时间：写入时用
datetime.now(timezone.utc)，查询时也用datetime.now(timezone.utc) - 确认字段类型：用
db.collection.find_one({})看一眼时间字段是不是ISODate，别是字符串 - 先测试再执行：加
.count_documents({})看匹配多少条，或用find()抽样检查
示例：
from datetime import datetime, timedelta
from pymongo import MongoClient
<p>client = MongoClient('mongodb://localhost:27017/')
db = client['mydb']
coll = db['logs']</p><h1>删除 7 天前的记录（假设字段是 expires_at）</h1><p>cutoff = datetime.now(timezone.utc) - timedelta(days=7)
result = coll.delete_many({'expires_at': {'$lt': cutoff}})
print(f'已删除 {result.deleted_count} 条')为什么不用 TTL 索引自动过期？
TTL 索引确实省事，但只适合“写入即确定过期时间”的场景，比如 session、缓存类数据。一旦你有动态调整过期策略的需求（比如运营活动延长保留时间），或者需要根据业务逻辑判断“过期”（比如订单状态为已取消才开始计时），TTL 就完全不可控。
立即学习“Python免费学习笔记（深入）”；
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
另一个硬伤是 TTL 索引强制要求字段是 Date 类型且不能是数组——如果存的是 [{"at": "..."}] 这种嵌套结构，TTL 直接失效。
- TTL 不支持复合条件：不能写成
{"status": "inactive", "expires_at": {"$lt": ...}} - 延迟不可控：MongoDB 每 60 秒扫描一次 TTL 索引，实际删除可能滞后数分钟
- 无法审计：删了谁、为什么删、删了多少，全无日志
批量删除时如何避免阻塞主业务？
大集合（千万级）直接 delete_many() 可能锁表几秒甚至更久，尤其在 WiredTiger 引擎下会触发大量 page fault。别指望加 hint() 能解决，真正有效的是分批 + 限速。
- 用
find().limit(n).sort('_id')找出一批待删 ID，再用delete_many({'_id': {'$in': id_list}}) - 每批最多 1000–5000 条，删完
time.sleep(0.1)让 I/O 缓一缓 - 加
coll.create_index('expires_at')—— 即使不用 TTL，这个索引对查询性能影响极大
注意：不要用 skip() 分页，数据量大时性能断崖式下降。
Python 连接与异常处理容易漏掉的点
很多人只 catch PyMongoError，但网络中断、权限不足、连接池耗尽这些情况会抛出不同异常。更麻烦的是，delete_many() 成功返回 result，但 result.acknowledged == False 时，其实什么都没删——这在 w=0 写入模式下会发生，而默认配置就是 w=1，所以得显式检查。
- 必须检查
result.acknowledged，否则 silent fail - 捕获
ConnectionFailure、OperationFailure、ServerSelectionTimeoutError三类核心异常 - 连接串里加上
?connectTimeoutMS=5000&socketTimeoutMS=10000，防卡死
过期清理不是一次性脚本，它迟早要进 crontab 或 Airflow。第一次跑通之后，记得把 cutoff 时间改成参数传入，别 hardcode 在代码里。
