Hibernate仅修改JSONB内部字段不触发更新的问题及优化方案咨询

问题现象 #

仅修改JSONB字段对应的Map内部元素时，Hibernate不会执行更新语句，但修改实体其他字段，或者重新创建Map对象并赋值给JSONB属性时，能正常触发更新：

不触发更新的代码 #

MyEntitity entity;
entity.getJSONB().put("Field", 14f); // 返回Map<String,Object>
session.merge(entity);

触发更新的代码1 #

MyEntitity entity;
entity.setX(12);
entity.getJSONB().put("Field", 14f); // 返回Map<String,Object>
session.merge(entity);

触发更新的代码2 #

MyEntitity entity;
HashMap<String, Object> newMap = new HashMap<String, Object>(entity.getJSONB());
newMap.put("Field", 14f);
entity.setJSONB(newMap);
session.merge(entity);

原因分析 #

这不是Hibernate的Bug，是其状态跟踪机制的正常表现：Hibernate通过对比实体属性的引用变化来判断是否需要执行更新。当你修改Map内部元素时，Map对象本身的引用没有改变，Hibernate检测不到该属性发生了变更，因此不会触发更新操作。而修改其他字段时，实体属性值的变化会被检测到，进而触发整个实体的更新；重新设置Map对象时，属性引用发生改变，同样会被Hibernate识别为变更。

更优解决方案 #

1. 手动标记属性为脏数据 #

修改Map内部值后，手动告诉Hibernate该属性已变更，触发更新：

entity.getJSONB().put("Field", 14f);
session.merge(entity);
// 标记JSONB属性为脏数据
((org.hibernate.Session) session).setDirty(entity, "JSONB");

或者通过元模型API标记：

entity.getJSONB().put("Field", 14f);
session.merge(entity);

session.getSessionFactory().getMetamodel()
       .entity(MyEntitity.class)
       .getProperty("JSONB")
       .markAsDirty(session, entity);

2. 在实体类中封装Map修改逻辑 #

在MyEntitity类中添加专门的方法修改JSONB字段，同时通过一个辅助字段触发Hibernate的变更检测：

public class MyEntitity {
    private Map<String, Object> JSONB;
    // 瞬态辅助字段，仅用于触发变更检测
    @Transient
    private int jsonbUpdateMarker;

    public void updateJSONB(String key, Object value) {
        this.JSONB.put(key, value);
        this.jsonbUpdateMarker++; // 修改辅助字段，让Hibernate检测到实体变更
    }
}

之后调用entity.updateJSONB("Field", 14f)即可触发更新，无需手动处理会话。

3. 使用支持内部变更检测的类型 #

在实体属性上配置@Type注解，指定支持集合内部变更检测的类型（需注意Hibernate版本兼容性）：

@Type(type = "org.hibernate.type.MapType", parameters = {
    @Parameter(name = "mutable", value = "true")
})
private Map<String, Object> JSONB;

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