使用Node.js MongoDB驱动在mLab创建TTL索引失败，expireAfterSeconds缺失排查

嘿，我来帮你搞定这个TTL索引失效的麻烦！这种情况我之前经手过好几个类似案例，大概率是以下几个常见操作失误导致的，咱们一个个排查：

• 字段类型不符合要求
  TTL索引的核心要求是：被索引的字段必须是Date类型（或者包含Date类型的数组，但很少用）。如果你存的是字符串格式的日期、Unix时间戳数字，MongoDB会直接忽略TTL设置。
  举个错误示例：

  // 错误：用字符串存日期
  db.collection('logs').insertOne({ expireAt: "2024-10-05T12:00:00Z" })
  

  正确做法：

  // 正确：用Date对象
  db.collection('logs').insertOne({ expireAt: new Date("2024-10-05T12:00:00Z") })
  

• 创建索引的语法写错了
  很多人会把expireAfterSeconds放到索引键的对象里，这是典型错误！Node.js驱动中，TTL选项是作为createIndex的第二个参数传入的，不是第一个索引键对象的属性。
  错误写法：

  // 错误：把expireAfterSeconds当成索引字段
  db.collection('logs').createIndex({ expireAt: 1, expireAfterSeconds: 0 })
  

  正确写法：

  // 正确：作为选项参数传入
  db.collection('logs').createIndex(
    { expireAt: 1 }, // 第一个参数：索引字段
    { expireAfterSeconds: 0 } // 第二个参数：索引选项，0表示按字段内的日期过期
  )
  

  （如果想设置固定过期时长，比如创建后3600秒过期，就把expireAfterSeconds设为3600即可）

• 索引创建未生效或有权限问题
  先确认索引是否真的创建成功，可以通过代码捕获错误，或者在mLab的控制台/用命令查看索引详情：

  // 查看集合所有索引
  db.collection('logs').getIndexes().then(indexes => console.log(indexes))
  

  如果输出的索引里没有expireAfterSeconds字段，说明创建过程可能失败了。检查一下mLab给你的数据库用户有没有createIndex权限，或者代码里有没有未捕获的异常。

• 复合索引无法启用TTL
  TTL索引只能是单字段索引，如果你给复合索引（比如{ expireAt: 1, userId: 1 }）添加expireAfterSeconds选项，MongoDB会直接忽略这个设置。必须单独给expireAt字段创建单字段的TTL索引。

• MongoDB版本过低（概率较低）
  虽然mLab现在归属于MongoDB Atlas，默认支持TTL，但如果你的集群用的是MongoDB 2.2之前的版本，TTL索引是不支持的。可以在mLab控制台查看集群的MongoDB版本，排除这个可能性。

排查完这些点，应该就能找到问题所在啦！

内容的提问来源于stack exchange，提问作者Lucas Neves