Spring Boot中MongoDB @Indexed(unique=true)不生效问题求助

嘿，这个问题我太熟了——好多朋友都碰到过：明明在TestData实体类的hash字段上加了@Indexed(unique = true)，结果还是能插入重复hash的文档，手动用Mongo Shell创建唯一索引却完全正常。别慌，咱们纯代码就能搞定，下面给你几个可靠的方案：

1. 先确认索引自动创建没被禁用 #

首先排查最常见的坑：Spring Data MongoDB的自动索引创建功能是不是被关掉了？

在Spring Boot 2.2+版本中，默认spring.data.mongodb.auto-index-creation是开启的，但如果你的配置文件里把它设成了false，那@Indexed注解根本不会生效。你可以在application.properties里明确开启：

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

或者用YAML格式：

spring:
  data:
    mongodb:
      auto-index-creation: true

如果之前没开，改完配置重启应用，@Indexed(unique=true)应该就能生效了。不过要是之前已经有旧的非唯一索引，得先在Mongo里删掉旧索引再重启，不然自动创建不会替换已有的索引。

2. 用MongoTemplate手动创建唯一索引（最可靠的方式） #

如果自动创建还是不行，或者你需要更灵活的控制，直接用MongoTemplate手动创建索引绝对靠谱。可以写个配置类，在应用启动时执行索引创建逻辑：

import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.data.mongodb.core.index.Index;
import javax.annotation.PostConstruct;

@Configuration
public class MongoIndexConfig {

    private final MongoTemplate mongoTemplate;

    // 构造注入MongoTemplate
    public MongoIndexConfig(MongoTemplate mongoTemplate) {
        this.mongoTemplate = mongoTemplate;
    }

    @PostConstruct
    public void createUniqueIndexes() {
        // 给TestData的hash字段创建唯一索引
        mongoTemplate.indexOps(TestData.class)
                .ensureIndex(new Index("hash", Index.Direction.ASC).unique());
    }
}

ensureIndex方法会先检查索引是否存在，不存在才创建，完全不用担心重复创建的问题。启动应用后，这个索引就会被自动创建好。

3. 换用@CompoundIndex注解定义 #

虽然你是单字段唯一索引，但用@CompoundIndex注解有时候比单独的@Indexed更稳定，写法也很简单：

@Data
@Builder
@Document(collection = "test")
@CompoundIndex(name = "hash_unique_idx", def = "{'hash': 1}", unique = true)
public class TestData {
    @Id
    private String id;
    private String name;
    // 这里可以去掉@Indexed，因为@CompoundIndex已经定义了唯一约束
    private String hash;
}

同样要确保自动索引创建开启，应用启动时就会自动生成这个唯一索引。

为啥@Indexed(unique=true)会失效？ #

最后给你梳理下常见原因，方便排查：

• 自动索引创建被禁用（就是第一条说的配置）；
• 实体类所在的包没被Spring扫描到，导致注解没被解析；
• 集合里已经存在没有唯一约束的旧索引，@Indexed不会自动替换旧索引，得先删旧的再重建；
• 极少数情况是MongoDB版本和Spring Data MongoDB版本不兼容。

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