Spring Boot整合MongoDB时如何实现字段唯一约束强制生效

注解方式不生效常见排查点 #

• 首先确认你使用的Spring Data MongoDB版本，3.0+版本的自动索引创建开关配置没有问题，但注意只有当Spring容器首次创建对应MongoRepository实例的时候才会触发索引创建，如果你是先启动项目创建了集合，之后才加的@Indexed注解，就算删了集合重启也可能因为Repository已经初始化过没有重新触发索引创建，可以尝试清理项目编译缓存后重新启动测试。
• @Id字段本身MongoDB就会默认生成唯一索引，不需要额外加@Indexed(unique = true)，冗余配置不会报错但没有必要，你的POJO可以简化为：

public class User {
    @Id
    private String id;
    @Indexed(unique = true)
    private String email;
    private int money;
}

方式1：全配置自动创建索引（推荐优先使用） #

确认在application.properties中添加以下配置：

# Spring Boot 2.x/3.x 通用开启自动索引创建
spring.data.mongodb.auto-index-creation=true

如果还是不生效，检查你是否使用了自定义的MongoTemplate配置类，如果手动配置了MongoTemplate实例，需要手动开启索引自动创建：

@Configuration
public class MongoConfig extends AbstractMongoClientConfiguration {
    @Override
    protected boolean autoIndexCreation() {
        return true;
    }
    // 其余你的Mongo配置逻辑
}

方式2：手动创建索引（兼容所有版本，无自动创建依赖） #

如果不想依赖自动配置，可以使用官方推荐的createIndex()方法实现，该方法是已废弃ensureIndex()的替代方案，用法如下：

基于MongoTemplate封装API实现 #

@Service
public class IndexInitService {
    private final MongoTemplate mongoTemplate;

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

    // 项目启动后执行一次即可
    @PostConstruct
    public void initUniqueIndex() {
        IndexOperations indexOps = mongoTemplate.indexOps(User.class);
        // 给email字段创建唯一索引
        IndexDefinition emailUniqueIndex = new Index().on("email", Sort.Direction.ASC).unique();
        indexOps.ensureIndex(emailUniqueIndex);
    }
}

基于原生MongoCollection API实现 #

如果直接调用MongoDB原生驱动接口，直接使用createIndex()方法即可：

mongoTemplate.getCollection("user").createIndex(Indexes.ascending("email").unique());

注解和手动创建的对比说明 #

• 注解方式优势是配置和实体类耦合，不需要额外写初始化代码，维护成本低，适合常规业务场景。
• 手动创建方式更灵活，可以支持复杂索引（比如复合唯一索引、稀疏索引、过期索引等），也适合需要动态创建索引的场景。
  两种方式底层都是调用MongoDB的索引创建接口，没有性能差异，可以根据自己的业务场景选择。

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