MongoDB带PartialFilterExpression的TTL索引失效问题排查

你遇到的问题核心在于对带partialFilterExpression的TTL索引创建规则理解有误，MongoDB对TTL索引的结构有严格要求，咱们一步步拆解：

错误原因 #

你创建的带过滤条件的TTL索引，key字段包含了source: 1：

{ "key" : { "systemEntryTime" : 1, "source" : 1 }, ... }

但MongoDB的TTL索引有个硬性规则：TTL索引的键必须是单个日期/时间类型的字段，不能包含其他非日期字段。这个多键索引虽然能创建成功，但MongoDB不会将它识别为有效的TTL索引，自然不会触发过期删除逻辑。

正确的索引创建方式 #

重新创建索引，只把systemEntryTime作为索引键，同时保留partialFilterExpression来过滤source="ftp"的文档：

db.item.createIndex(
  { systemEntryTime: 1 },
  {
    name: "systemEntryTime_1_ftp",
    expireAfterSeconds: 1,
    partialFilterExpression: { source: { $eq: "ftp" } }
  }
)

后续注意事项 #

• 清理旧索引：先删除之前的两个索引（原默认TTL索引和错误的多键TTL索引），避免索引冲突：

  db.item.dropIndex("systemEntryTime_1")
  db.item.dropIndex("systemEntryTime_1_source_1")
  

• 等待后台任务执行：MongoDB的TTL删除是后台定时线程处理的，默认每60秒扫描一次索引，所以即使设置了expireAfterSeconds:1，也需要等待一小段时间才会看到文档被删除，不是立即生效。
• 验证字段类型：确保systemEntryTime字段是ISODate类型，而非字符串或其他类型——TTL索引只对日期类型字段生效。
• 确认索引状态：用db.item.getIndexes()查看索引列表，确保新创建的索引结构正确，partialFilterExpression和expireAfterSeconds参数都符合预期。

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