使用Spring Data MongoDB时如何更新复合唯一索引？

和PostgreSQL这类RDBMS直接修改约束的方式不同，MongoDB不支持直接修改已存在的索引，必须先删除旧索引，再创建包含新字段的新索引。以下是具体操作流程：

1. 修改实体类的索引注解 #

更新Person类上的@CompoundIndex注解，将ssn字段加入复合索引的字段列表，保持索引名称不变（或按需修改，这里沿用原名称unique_name_with_age）：

@Document(collection = "person")
@CompoundIndex(name = "unique_name_with_age", def = "{'firstName': 1, 'lastName': 1, 'ssn': 1}", unique = true)
public class Person {
    // 字段定义：firstName、lastName、ssn...
}

2. 删除旧索引 #

由于Spring Data MongoDB默认只会创建不存在的索引，不会自动更新已存在的索引，所以必须先删除旧索引，有两种实现方式：

方式一：手动通过MongoDB Shell删除 #

连接到MongoDB实例，执行以下命令（person为集合名，对应实体类@Document指定的集合，未指定则为类名小写）：

db.person.dropIndex("unique_name_with_age")

方式二：通过应用启动代码自动删除 #

如果需要自动化迁移，可以编写启动时执行的Bean，借助MongoTemplate完成删除：

@Component
public class IndexMigrationRunner implements ApplicationRunner {

    private final MongoTemplate mongoTemplate;

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

    @Override
    public void run(ApplicationArguments args) {
        mongoTemplate.getCollection("person").dropIndex("unique_name_with_age");
    }
}

3. 创建新索引 #

旧索引删除完成后，可通过两种方式创建新的复合唯一索引：

方式一：依赖Spring Data自动索引创建 #

确保应用配置中开启自动索引创建（Spring Boot开发环境默认开启，生产环境需手动配置）：
在application.properties中添加：

spring.data.mongodb.auto-index-creation=true

重启应用后，Spring Data会根据实体类的注解自动创建新索引。

方式二：通过代码手动创建 #

若不想依赖自动索引创建，可在启动Bean中直接创建新索引：

// 承接上面的IndexMigrationRunner类
@Override
public void run(ApplicationArguments args) {
    // 删除旧索引
    mongoTemplate.getCollection("person").dropIndex("unique_name_with_age");
    
    // 创建新索引
    IndexOperations indexOps = mongoTemplate.indexOps(Person.class);
    CompoundIndexDefinition newIndex = new CompoundIndexDefinition()
            .on("firstName", Sort.Direction.ASC)
            .on("lastName", Sort.Direction.ASC)
            .on("ssn", Sort.Direction.ASC)
            .unique()
            .named("unique_name_with_age");
    indexOps.ensureIndex(newIndex);
}

4. 前置检查：确保现有数据符合新约束 #

创建新索引前，必须检查现有数据中是否存在firstName + lastName + ssn重复的记录，否则索引创建会失败。可通过MongoDB Shell执行聚合查询排查：

db.person.aggregate([
    { $group: { 
        _id: { firstName: "$firstName", lastName: "$lastName", ssn: "$ssn" }, 
        count: { $sum: 1 } 
    }},
    { $match: { count: { $gt: 1 } }}
])

若返回结果，说明存在重复数据，需先清理后再创建索引。

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