Spring Data MongoDB中@Update结合$inc更新嵌套字段失效问题

核心问题 #

你遇到的情况是Spring Data MongoDB的乐观锁机制在干扰自定义更新语句。如果实体类中使用了@Version注解实现乐观锁，框架会自动将所有更新操作的$inc部分替换为version字段的自增，覆盖了你手动编写的balance.available增量更新逻辑，这就是只有balance.updatedAt生效的原因。

解决办法 #

1. 移除乐观锁（若业务不需要） #

如果你的场景不需要乐观锁控制，直接删除实体类中的@Version注解即可。此时@Query+@Update的写法就能正常工作，示例代码如下：

public interface YourEntityRepository extends MongoRepository<YourEntity, String> {
    @Query("{ '_id' : ?0 }")
    @Update("{ '$inc' : { 'balance.available' : ?1 }, '$set' : { 'balance.updatedAt' : ?2 } }")
    void updateBalance(String entityId, long incrementAmount, LocalDateTime updateTime);
}

2. 保留乐观锁时的替代方案 #

如果必须保留乐观锁，@Query+@Update的常规写法确实不支持同时自定义$inc和框架自动的version自增，此时有两种可行方案：

• 使用@Update的pipeline参数：这是你已经验证过可行的方式，虽写法稍复杂，但能兼容乐观锁。
• 使用MongoTemplate手动执行更新：完全自定义update语句，同时手动处理version自增，示例代码：

@Autowired
private MongoTemplate mongoTemplate;

public void updateBalanceWithVersion(String entityId, long incrementAmount, long currentVersion) {
    Update update = new Update()
            .inc("balance.available", incrementAmount)
            .set("balance.updatedAt", LocalDateTime.now())
            .inc("version", 1); // 手动处理乐观锁版本自增

    mongoTemplate.updateFirst(
            Query.query(Criteria.where("_id").is(entityId).and("version").is(currentVersion)),
            update,
            YourEntity.class
    );
}

结论 #

当实体类启用乐观锁（带@Version）时，@Query+@Update的常规写法无法同时自定义$inc操作，因为框架会强制替换$inc为version自增。如果想保持易读的写法，只能移除乐观锁；否则就需要使用pipeline或MongoTemplate来实现。

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