MongoTemplate findAndModify upsert根文档报_id字段非法问题咨询

你遇到的Invalid BSON field name _id报错核心原因如下：

• 你使用Update.fromDocument(document)构造更新对象时，会将序列化后得到的完整Bson文档（包含顶层_id字段）直接解析为更新操作字段，而MongoDB协议明确禁止在更新操作的根层级传入_id字段——即使该值和查询条件中的_id完全一致，Bson序列化阶段也会直接抛出参数异常。
• 你的查询条件中使用了字段名id，如果对应实体类的主键字段没有显式标注@Id注解，Spring Data MongoDB不会自动将其映射为MongoDB的实际主键字段_id，会进一步导致查询匹配异常。

另外你当前选择findAndModify实现全量文档替换本身就是语义错配：findAndModify设计用于部分字段更新，全量文档替换upsert应该优先使用findAndReplace接口，和你写的原生MongoDB语法语义完全对齐。

根据你要「返回最新文档」「一套逻辑兼容根/嵌套文档」的两个需求，提供两种可直接落地的写法： #

方案1：根文档场景用findAndReplace（推荐，语义最匹配） #

直接使用Spring Data MongoDB提供的findAndReplace接口实现全量替换upsert，不需要手动序列化文档、构造Update对象，框架会自动处理_id字段的合法性问题，代码如下：

// 构造查询条件，主键字段统一用_id避免映射问题
Query query = Query.query(Criteria.where("_id").is("XXXX01"));
// 配置操作选项：开启upsert、返回操作后的新文档
FindAndReplaceOptions options = FindAndReplaceOptions.options()
        .upsert(true)
        .returnNew();
// 执行替换操作，直接返回映射好的实体对象
YourEntity result = mongoTemplate.findAndReplace(
        query,
        javaObjectRepresentingTheDocument,
        options,
        YourEntity.class,
        collectionName
);

方案2：统一findAndModify入口（适配现有嵌套文档通用逻辑） #

如果你需要把根文档和嵌套文档的逻辑收敛到同一个通用方法，不想拆分findAndReplace/findAndModify分支，只需要在构造根文档更新对象时做两个小改动：

1. 序列化文档后手动移除顶层_id字段
2. 用$set操作包裹所有业务字段，不要直接把裸文档传给Update.fromDocument

代码如下：

Document doc = new Document();
mongoTemplate.getConverter().write(javaObjectRepresentingTheDocument, doc);
// 核心改动1：移除不可更新的顶层_id字段，upsert时会根据查询条件自动填充_id
doc.remove("_id");
// 核心改动2：用$set包裹全量字段，避免_id被解析为顶层更新操作
Update update = new Update().set("$set", doc);

Query query = Query.query(Criteria.where("_id").is("XXXX01"));
YourEntity result = mongoTemplate.findAndModify(
        query,
        update,
        FindAndModifyOptions.options().upsert(true).returnNew(true),
        YourEntity.class,
        collectionName
);

该写法的执行效果和你写的原生MongoDB语法完全一致：查询到匹配_id的文档时全量覆盖所有业务字段，未匹配时插入带对应_id的新文档，最终返回最新的文档实体。 #

如果你要做根、child、grandChild三层的通用CRUD封装，只需要加一层简单的层级判断即可：

• 根层级：使用上述两种方案任意一种即可
• child/grandChild嵌套数组层级：保留你现有基于数组过滤选择器$[<identifier>]的写法即可，注意如果是替换匹配的数组元素而非追加，把addToSet换成set即可，addToSet仅用于数组去重追加场景。

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