Spring Boot 执行MongoDB部分更新时抛出BsonInvalidOperationException如何解决？

• 核心原因是混用了JPA的JPQL更新语法与Spring Data MongoDB的查询注解：@Modifying+@Query写JPQL更新语句是JPA（关系型数据库）的用法，Spring Data MongoDB的@Query注解仅用来定义查询过滤条件，不支持直接写入update更新语句。你将更新语句写入@Query后，框架会将整段update字符串当作BSON文档解析，期望拿到DOCUMENT类型却得到STRING类型，直接触发该异常。
• 字段映射不匹配：实体类主键字段定义为_id，但Repository的更新语句中使用了r.id作为查询条件，字段名对应错误。
• 冗余注解：实体类上同时标注了JPA专用的@Entity和MongoDB专用的@Document，属于不必要的冗余配置，虽然不是本次报错的直接原因，但可能引发其他映射问题。

这里提供两种常用的部分更新实现方式：

方案1：使用MongoTemplate实现部分更新（推荐，性能更高） #

直接在Service层注入MongoTemplate编写更新逻辑，不需要修改Repository代码：

@Autowired
private MongoTemplate mongoTemplate;

public void updateStatus(String id, String status) {
    // 构造查询条件：匹配_id
    Query query = Query.query(Criteria.where("_id").is(id));
    // 构造更新内容：仅修改isActive字段
    Update update = Update.update("isActive", status);
    // 执行单条更新
    mongoTemplate.updateFirst(query, update, Customer.class);
}

方案2：使用@Update注解改写Repository方法 #

如果希望通过Repository接口实现，需使用Spring Data MongoDB提供的@Update注解单独定义更新逻辑：

@Repository
public interface CustomerRepository extends MongoRepository<Customer, String> {
    @Modifying
    // @Query定义查询过滤条件
    @Query(value = "{ '_id': ?0 }")
    // @Update定义更新操作
    @Update("{ '$set' : { 'isActive' : ?1 } }")
    int updateStatus(String id, String status);
}

• 移除实体类上多余的@Entity注解，仅保留@Document即可。
• 修正实体类中的字段拼写错误：String mane大概率是String name的笔误。
• 如果希望实体类主键字段使用id而非_id，可以给字段添加@Field("_id")注解完成映射，避免后续条件写错位。

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