Spring Boot 3集成MongoDB：复合唯一索引配置失效问题求助

1. 开启索引自动创建功能 #

Spring Boot 3 对应的 Spring Data MongoDB 4.x 版本，默认关闭了索引自动创建，需要显式开启：

在 application.properties 中添加：

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

或者 application.yml：

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

2. 确认实体类被Spring扫描到 #

检查 @EnableMongoRepositories 注解的扫描范围，如果 Asset 实体类不在配置类 MongoConfiguration 的同级或子包下，需要指定 basePackages：

@Configuration
@EnableMongoRepositories(basePackages = "com.yourpackage.asset") // 替换为Asset所在的实际包路径
@Slf4j
public class MongoConfiguration {
    private final String mongoDatabaseName = "testNoSql";
    private final String mongoDatabaseAddress = "localhost:27017";
}

3. 修正复合索引注解写法（避免语法错误） #

你的注解逻辑没问题，但可以用更直观的字段引用方式替代JSON字符串，减少语法出错概率：

@Document("Asset")
@CompoundIndex(def = "{userId: 1, name: 1}", unique = true)
public class Asset {
    @Id
    private String id;
    private String userId;
    private String name;
    // getter/setter方法
}

注：此处无需给字段名加引号，Spring Data MongoDB会自动解析。

4. 手动创建正确的复合唯一索引 #

如果自动创建仍不生效，可通过MongoDB Shell执行命令手动创建符合要求的索引：

db.Asset.createIndex({userId: 1, name: 1}, {unique: true})

执行完成后，在MongoDB Compass中查看索引，会看到包含userId和name两个字段的复合唯一索引——此时同一userId下可添加不同name的条目，仅当userId和name同时相同时才会触发唯一约束。

5. 用MongoTemplate手动初始化索引（兜底方案） #

如果以上方法均无效，可在应用启动时通过MongoTemplate强制创建索引：

@Component
public class IndexInitializer implements ApplicationRunner {

    private final MongoTemplate mongoTemplate;

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

    @Override
    public void run(ApplicationArguments args) throws Exception {
        IndexOperations indexOps = mongoTemplate.indexOps(Asset.class);
        IndexDefinition compoundIndex = new CompoundIndexDefinition()
                .on("userId", Sort.Direction.ASC)
                .on("name", Sort.Direction.ASC)
                .unique();
        indexOps.ensureIndex(compoundIndex);
    }
}

该组件会在应用启动时自动执行，确保复合索引被创建。

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