使用MongoTemplate的save()更新文档时触发重复键错误

问题原因 #

MongoTemplate的save()方法逻辑是：若传入文档包含_id，则先查询集合中是否存在该_id的文档——存在则更新，不存在则插入。触发E11000错误，大概率是以下两种情况：

1. 实体类的_id字段未正确配置注解，导致Spring Data MongoDB无法识别主键，误将更新操作判定为插入；
2. 传入的_id类型与数据库中存储的类型不匹配（比如库中是ObjectId，你传的是未转换的字符串），导致查询不到已有文档，进而执行插入触发重复键冲突。

解决方案 #

1. 修正实体类的主键注解

确保实体类的主键字段用@Id标记，Spring Data MongoDB会自动处理_id的类型转换与主键识别：

import org.springframework.data.annotation.Id;
import org.bson.types.ObjectId;

public class YourDocument {
    @Id
    // 支持String或ObjectId类型，String类型会自动与库中的ObjectId互转
    private String id; 
    // 其他业务字段...
}

配置正确后，直接调用save()即可正常执行更新/插入逻辑，不会触发重复键错误。

2. 确保_id类型匹配

如果数据库中_id是ObjectId类型，而你用字符串形式传入主键，需确保转换正确：

// 比如从前端拿到的字符串id
String targetId = "60d21b4667d0d8992e610c85";
YourDocument doc = new YourDocument();
// 若实体类id是ObjectId类型，需手动转换
doc.setId(new ObjectId(targetId));
// 给其他字段赋值
doc.setField1("updatedValue");
// 调用save更新
mongoTemplate.save(doc);

3. 用upsert替代save（更稳妥的方案）

如果不想纠结实体类配置，直接用upsert()方法实现「存在则更新，不存在则插入」的逻辑，无需手动编写大量更新字段：

import org.springframework.data.mongodb.core.query.Criteria;
import org.springframework.data.mongodb.core.query.Query;
import org.springframework.data.mongodb.core.query.Update;

// 指定要更新的文档id
Query query = Query.query(Criteria.where("_id").is(targetId));
// 将整个对象转为更新操作
Update update = Update.fromObject(doc);
// 执行upsert
mongoTemplate.upsert(query, update, YourDocument.class);

这个方法会自动处理主键匹配，既避免了重复键错误，又不用像update()那样逐个字段设置更新内容。

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