如何在Quarkus 3.1.2(Hibernate Reactive)中更新一对多实体数据

我有一对多映射的两个实体，对应数据库表key和value（多个Value关联一个Key）。实体定义已经配置了CascadeType.ALL级联操作，但用下面的代码批量更新Value表数据时无法生效：

return Panache.withTransaction(() -> {
    Session session = PanacheEntityBase.getSession().subscribeAsCompletionStage().join();
    session.mergeAll(updatedList);
    return Uni.createFrom().item(updatedList);
}

实体定义如下：

Key实体 #

@Entity
@Table(name = "key")
public class Key extends BaseEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    public Long id;

    @Column(name = "name", unique = true, nullable = false)
    private String name;

    @OneToMany(mappedBy = "key", cascade = CascadeType.ALL, fetch = FetchType.EAGER)
    private List<Value> values;

}

Value实体 #

@Entity
@Table(name = "value")
public class Value extends BaseEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    public Long id;

    @Column(name = "name", nullable = false)
    private String name;

    /**
     * To map the key id
     */
    @ManyToOne(fetch = FetchType.EAGER, cascade = CascadeType.ALL)
    @JoinColumn(name = "key_id", nullable = false)
    private Key key;
}

问题根源 #

1. mergeAll仅完成实体状态合并，不会自动触发变更同步到数据库，游离状态的实体变更无法被Hibernate感知。
2. 代码未显式调用flush()，导致事务提交前变更未写入数据库。
3. Value的@ManyToOne配置了CascadeType.ALL，可能引发不必要的Key实体级联操作，干扰Value的独立更新。

可行解决办法 #

方法一：使用Panache原生批量更新（推荐）

Panache自带实体状态跟踪，无需手动操作Session，代码更简洁可靠：

return Panache.withTransaction(() -> {
    for (Value value : updatedList) {
        // 获取当前Session托管的Value实体
        Value attachedValue = Value.findById(value.id);
        if (attachedValue != null) {
            // 更新目标字段
            attachedValue.setName(value.getName());
            // Panache会自动跟踪变更，事务提交时同步到数据库
        }
    }
    return Uni.createFrom().item(updatedList);
});

方法二：修正Session操作逻辑

如果坚持使用Session，需确保实体被托管并触发变更同步：

return Panache.withTransaction(() -> {
    Session session = PanacheEntityBase.getSession().subscribeAsCompletionStage().join();
    for (Value value : updatedList) {
        // merge后返回托管状态的实体
        Value managedValue = session.merge(value);
        // 显式标记实体为脏状态，确保Hibernate感知变更
        session.markDirty(managedValue);
    }
    // 强制将变更同步到数据库
    session.flush();
    return Uni.createFrom().item(updatedList);
});

方法三：优化实体映射配置

建议移除Value中@ManyToOne的CascadeType.ALL，除非你确实需要级联操作Key实体，避免意外的关联实体变更：

@ManyToOne(fetch = FetchType.EAGER)
@JoinColumn(name = "key_id", nullable = false)
private Key key;

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