MongoDB创建部分唯一索引：实现特定状态下字段唯一性约束

哦，这个问题我之前也碰到过！你写的部分唯一索引逻辑本身是对的，但大概率是因为旧的普通唯一索引还在生效，或者索引没有正确创建导致的。让我一步步帮你解决：

第一步：排查并清理旧索引 #

首先要确认你的集合里是不是已经存在一个针对name字段的普通唯一索引——这会直接覆盖部分索引的效果，导致即使是非ACTIVE状态的任务也会触发唯一约束。

登录MongoDB shell，执行以下命令查看集合的所有索引（假设你的集合名是downloadJob，对应DownloadJob实体类）：

db.downloadJob.getIndexes()

如果看到类似下面的索引，说明有旧的普通唯一索引存在：

{
  "v" : 2,
  "key" : { "name" : 1 },
  "name" : "name_1",
  "unique" : true
}

赶紧删掉它：

db.downloadJob.dropIndex("name_1")

第二步：正确创建部分唯一索引 #

你的代码逻辑没问题，但可以再优化一下写法，确保索引被正确创建。或者用实体类注解的方式更直观：

方式一：通过Spring Data注解定义（推荐） #

直接在DownloadJob实体类上添加@CompoundIndex注解，明确指定部分过滤条件：

import org.springframework.data.mongodb.core.index.CompoundIndex;
import org.springframework.data.mongodb.core.mapping.Document;

@Document(collection = "downloadJob")
@CompoundIndex(
    name = "name_active_unique",
    def = "{'name': 1}",
    unique = true,
    partialFilterExpression = "{'state': 'ACTIVE'}"
)
public class DownloadJob {
    private String name;
    private String state;
    // 其他字段、Getter、Setter
}

方式二：通过MongoTemplate创建 #

如果还是想用代码创建，你的原代码可以保留，但建议加上索引名称，方便后续管理：

IndexFilter onlyActive = PartialIndexFilter.of(Criteria.where("state").is("ACTIVE"));
mongoTemplate.indexOps(DownloadJob.class)
    .ensureIndex(
        new Index()
            .on("name", Sort.Direction.ASC)
            .named("name_active_unique")
            .partial(onlyActive)
            .unique()
    );

第三步：验证索引是否正确创建 #

再次执行db.downloadJob.getIndexes()，你应该能看到类似这样的索引条目，说明部分唯一索引生效了：

{
  "v" : 2,
  "key" : { "name" : 1 },
  "name" : "name_active_unique",
  "unique" : true,
  "partialFilterExpression" : { "state" : "ACTIVE" }
}

第四步：测试约束效果 #

现在可以测试各种场景，确认符合你的需求：

• ✅ 插入name="job1"、state="ACTIVE"：成功
• ❌ 再次插入name="job1"、state="ACTIVE"：抛出重复键异常（符合预期）
• ✅ 插入name="job1"、state="COMPLETED"：成功
• ✅ 插入name="job1"、state="FAILED"：成功

注意事项 #

• 确保你的MongoDB版本不低于3.2（部分唯一索引是3.2版本开始支持的）
• 如果是多节点集群，要等待索引在所有节点上同步完成再测试

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