本文详解如何使用mgo.v2在Go中为MongoDB集合创建TTL索引，使仅含有效expireAt字段的文档被自动删除，而缺失该字段的文档永久保留，从而在同一集合中灵活支持持久化与临时数据共存。
本文详解如何使用mgo.v2在go中为mongodb集合创建ttl索引，使仅含有效`expireat`字段的文档被自动删除，而缺失该字段的文档永久保留，从而在同一集合中灵活支持持久化与临时数据共存。
在MongoDB中，TTL（Time-To-Live）索引是一种特殊单字段索引，可自动删除已过期的文档。但其行为高度依赖字段值的有效性与存在性——只有当目标字段（如expireAt）存在且为合法UTC时间时，文档才纳入TTL清理范围；若字段缺失或为null，则完全忽略该文档。这一特性恰好满足“同一集合内混合持久/临时文档”的典型场景。
要正确实现该机制，需同时配置服务端索引与客户端结构体序列化策略：
✅ 正确创建TTL索引（mgo.v2）
index := mgo.Index{
Key: []string{"expireAt"}, // 索引字段名，必须与bson tag一致
ExpireAfter: 0, // 关键：设为0表示"立即过期"（以字段值为绝对截止时间）
}
err := collection.EnsureIndex(index)
if err != nil {
log.Fatal("Failed to create TTL index:", err)
}⚠️ 注意：ExpireAfter: 0 并非“不生效”，而是启用MongoDB的绝对时间TTL模式——即文档将在 expireAt 字段指定的UTC时间点之后被删除（通常1–60秒内触发后台任务）。这正是你原始Mongo Shell命令 expireAfterSeconds: 0 的等效写法。
✅ 结构体定义：用 omitempty 控制字段存在性
type Filter struct {
Timestamp time.Time `bson:"createdAt"`
Body string `bson:"body"`
ExpireAt time.Time `bson:"expireAt,omitempty"` // ← 核心！零值时不写入数据库
}- omitempty 是关键：当 ExpireAt 为 time.Time{}（即零值）时，bson.Marshal 将完全省略该字段，MongoDB中对应文档无 expireAt 键。
- 因此，expireAt 字段只存在于明确设置了过期时间的文档中，天然规避了“零值时间被误判为有效过期时间”的风险（如 0001-01-01T00:00:00Z 虽是合法时间，但因未序列化，根本不会进入数据库）。
✅ 使用示例：混合插入与动态更新
// 持久化文档（无expireAt字段）
persistent := Filter{
Timestamp: time.Now(),
Body: "This stays forever",
}
collection.Insert(persistent)
// 临时文档（显式设置expireAt）
temp := Filter{
Timestamp: time.Now(),
Body: "Expires in 14 days",
ExpireAt: time.Now().Add(14 * 24 * time.Hour),
}
collection.Insert(temp)
// 后续可动态"激活"持久文档的过期行为
query := bson.M{"body": "This stays forever"}
update := bson.M{"$set": bson.M{"expireAt": time.Now().Add(1 * time.Hour)}}
collection.Update(query, update) // 此后该文档将按新expireAt自动过期⚠️ 重要注意事项
- 索引必须提前创建：EnsureIndex() 应在应用初始化阶段执行一次，避免重复建索引开销。
- 时间精度与时区：expireAt 值必须为UTC时间（time.Time 默认为本地时区），建议统一转换：t.UTC()。
- 后台清理延迟：MongoDB每60秒扫描一次TTL索引，实际删除可能有分钟级延迟，不可用于强实时场景。
- 替代方案考量：若需精确控制删除时机，可结合定期Job查询 expireAt <= now 并调用 Remove()，但会增加应用复杂度。
通过以上组合设计，你无需拆分集合或引入额外标记字段，即可在单一Filter集合中优雅实现“按需过期”语义——既符合MongoDB TTL原生能力，又契合Go类型安全与序列化最佳实践。
