Spring Data MongoDB带partialFilter的唯一索引抛出DuplicateKeyException问题

问题底层原因 #

1. 索引设计冗余（非根因但属于不规范实现） #

你要实现「同一任务名称仅存在一个ACTIVE状态任务」的需求，不需要把state字段加入索引键。你当前的设计把name+state同时作为唯一索引键，再搭配state="ACTIVE"的部分过滤条件，虽然在正常场景下也能达到效果，但属于冗余设计，放大了后续操作的异常风险。
正确的索引设计应该仅对name做唯一键，搭配部分过滤条件即可：

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

2. Spring Data MongoDB save()方法的执行逻辑差异（根因） #

MongoRepository.save()方法会根据传入对象是否为持久化上下文托管对象，生成完全不同的Mongo操作：

• 当你传入的是从Repository查询返回的reRead1对象时：该对象被持久化上下文托管，框架会跟踪字段变更，最终生成update操作，仅更新修改的state字段。
  这个操作的Mongo执行流程是：匹配id找到文档 -> 将文档从部分索引（原state为ACTIVE，属于索引覆盖范围）中移除 -> 更新state为TIMEOUT，全程不会触发唯一键冲突。
• 当你传入的是手动新建的copyOf1对象时：该对象没有被持久化上下文托管，就算手动设置了id字段，框架也会默认执行replaceOne操作，用新对象的全量字段覆盖对应id的旧文档。
  如果你使用的是4.2版本以下的MongoDB，replaceOne的唯一约束校验顺序存在缺陷：会先校验新文档的键是否冲突，再处理旧文档的索引移除。虽然你的新文档state为TIMEOUT，不符合部分索引的过滤条件，但旧版本Mongo在校验时会误判，认为修改后的name+state组合和已存在的同名TIMEOUT任务的组合违反唯一约束，这就是你遇到DuplicateKeyException的直接原因。

解决方案 #

1. 优先修正索引设计：移除索引键中的state字段，仅保留name作为唯一键，搭配部分过滤条件，从根源上避免state字段修改带来的索引冲突。
2. 若暂时无法修改索引，在修改状态的场景优先使用update类操作而非全量save：

// 示例：仅更新state字段
Query query = Query.query(Criteria.where("id").is(jobId));
Update update = Update.update("state", State.TIMEOUT);
mongoTemplate.updateFirst(query, update, DownloadJob.class);

3. 若必须使用save方法，不要手动新建对象设置id，优先从Repository查询出对应文档，修改字段后再调用save，避免触发全量替换逻辑。

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