在日常开发里日志表、会话表、临时缓存往往只需要保留Zui近几天的数据。手动写脚本去删库删表既麻烦又容易出错，这时候 MongoDB 自带的 TTL索引就像一位勤快的保洁员，帮你把“过期”标记的文档悄悄搬走。

TTL 索引本质上是一种普通的单字段索引，只是它多了一个叫 expireAfterSeconds 的参数。当集合里的某条记录在指定的日期字段上超过了这个秒数，MongoDB 的后台线程会把它挑出来删除。

它Zui适合以下场景：

服务器日志、审计记录——只保留Zui近 7 天。

用户会话或验证码——几分钟后失效。

缓存表——数据一旦陈旧即被清除。

值得注意的是：TTL 并非即时删除，MongoDB 每隔 60 秒检查一次符合条件的文档，所以实际删除会有几秒到一分钟左右的延迟。

在创建 TTL 索引前，需要确认两件事：

字段必须是 Date 类型或包含 Date 的数组。Ru果是字符串或数字，索引根本不会生效。

Mongod 正常运行且Yi连接到目标数据库。Ke以用 mongo --quiet 快速登录检查。

顺便说一句，今天喝的咖啡稍微有点苦，但正好提神，让我geng专注于代码细节。

use myApp;
// 插入三条日志，其中两条人为“老旧”
db.logs.insertMany();

db.logs.createIndex(
    { createdAt: 1 },                     // 按日期升序建普通索引
    { expireAfterSeconds: 3600 }          // 超过一小时后自动删除
);

小贴士：Ru果想让索引用geng易辨认，Ke以加上 { name: "logs_createdAt_ttl" }.

db.logs.getIndexes;

返回结果中会出现类似下面的一行：

{
    "v" : 2,
    "key" : { "createdAt" : 1 },
    "name" : "logs_createdAt_ttl",
    "expireAfterSeconds" : 3600
}

TLL 检查器每分钟跑一次你Ke以先用以下命令确认当前集合里还有哪些文档：

db.logs.find.pretty;

大约等满一小时再执行同样查询，你会发现「两小时前」和「一天前」那两条记录Yi经消失，只剩下Zui新的一条。恭喜，你Yi经成功让 MongoDB 自动Zuo垃圾回收！ 🎉

Mongoose 提供了geng友好的方式在模型层面声明 TTL，只要在 schema 中给日期字段加上 `expires` 属性即可。

const mongoose = require;
mongoose.connect('mongodb://127.0.0.1:27017/myApp', {
    useNewUrlParser: true,
    useUnifiedTopology: true
});
const logSchema = new mongoose.Schema({
    msg       : String,
    createdAt : {
        type   : Date,
        default: Date.now,
        index  : { expires: '1h' }          // 自动转成 ttl 索引
        // 或者写成 expires: 3600
    }
});
const Log = mongoose.model;
// 插入测试数据
Log.create;
Log.create - 30*60*1000) });
Log.create - 90*60*1000) });

Mongoose 会在第一次连接时为 `createdAt` 字段生成相同结构的 TTL 索引，你完全不必手动跑 `createIndex` 命令。只要保证模型定义不变，就Neng一直保持自动清理功Neng。

TLL 支持对包含多个日期值的数组字段建立索引，只要数组里任意一个元素满足过期条件，该整条文档就会被删掉。这在「消息历史」或「多阶段任务」场景里非常实用。

// 创建一个存放多时间戳的集合
db.events.createIndex(
    { timestamps : 1 },
    { expireAfterSeconds : 7 * 24 * 60 * 60 }   // 保留七天
);
// 插入示例文档，timestamps 为数组
db.events.insertOne({
    name       : '项目迭代',
    timestamps : 
});

因为数组里有一个「十天前」Yi经超出七天限制，这整条记录将在下次 TTL 检查时被移除。注意：

TLL 不支持复合索引，即只Neng针对单个键建立；Ru果需要对两个不同字段分别设置不同期限，请分别创建两个单独的 TTL 索引。

Date 数组内部顺序无关紧要，只要有任意元素满足条件即触发删除。

TLL 清理线程默认每分钟运行一次。Ru果业务对「刚好到期」的数据要求极高，请额外配合应用层逻辑Zuo一次手动清理，以免出现「数据仍然可见」的小窗口。

Mongod 在扫描索引时只kan BSON 类型。Ru果把字符串形式的时间戳存进去，即使设置了 `expireAfterSeconds`，也不会触发任何删除操作。建议统一使用 ISODate 或 JavaScript 的 `new Date` 对象。