如何用Spring Data MongoDB注解为转换后的子文档字段建索引

数据老陈

2026-8-24

Spring Data MongoDB 自定义类型子字段TTL索引实现问题

结论

无法通过Spring Data MongoDB的注解直接实现给自定义类型的子字段（superField.field1）创建带过期时间的TTL索引，必须通过MongoTemplate手动创建。

原因

@Indexed注解只能作用于实体类的直接字段：当你给Doc类的superField字段标注@Indexed时，Spring Data会基于整个superField子文档创建索引，无法定位到其内部的field1属性。
@CompoundIndex同样不支持这种场景：它要求索引路径对应实体的直接映射字段，而自定义类型MySuperField的内部字段在Doc实体层面没有暴露为直接属性（硬编码暴露getter/setter不符合封装逻辑），无法通过注解指定superField.field1的索引规则。

手动创建索引的实现代码

通过MongoTemplate在应用启动时初始化TTL索引，示例如下：

@Configuration
public class MongoIndexConfiguration {

    private final MongoTemplate mongoTemplate;

    public MongoIndexConfiguration(MongoTemplate mongoTemplate) {
        this.mongoTemplate = mongoTemplate;
    }

    @PostConstruct
    public void initTTLIndex() {
        // 针对superField.field1创建TTL索引，设置过期时间为24小时（可按需调整）
        IndexOperations indexOperations = mongoTemplate.indexOps(Doc.class);
        indexOperations.ensureIndex(
            Index.index("superField.field1", Sort.Direction.ASC)
                  .expire(24, TimeUnit.HOURS)
        );
    }
}