Reactive Panache关联查询报JsonMappingException集合无法初始化错误

问题根因 #

你遇到的HR000056错误是Hibernate Reactive的典型懒加载异常：

• @OneToMany关联默认使用FetchType.LAZY懒加载策略，调用listAll()查询Template时，仅返回Template的基础字段，sections属性会被Hibernate替换为未初始化的代理集合，你在实体中初始化的空集合会被覆盖
• 接口返回时Jackson序列化需要读取sections属性值，但此时Hibernate会话已经关闭，响应式编程模型不支持会话外异步初始化懒加载集合，因此抛出序列化异常

解决方案 #

可根据你的业务需求选择以下任意一种方案：

方案1：查询时主动关联抓取sections #

修改查询逻辑，使用LEFT JOIN FETCH在查询Template时同步加载关联的sections集合，是最推荐的方案，不会改变全局加载策略：

@GET
@Path("template")
public Uni<List<Template>> listTemplates() {
    // 加DISTINCT避免关联查询返回重复的Template记录
    return Template.list("SELECT DISTINCT t FROM Template t LEFT JOIN FETCH t.sections");
}

方案2：修改关联为即时加载 #

在@OneToMany注解上显式指定加载策略为即时加载，后续所有查询Template的操作都会自动加载sections：

@OneToMany(mappedBy = "template", cascade = CascadeType.ALL, fetch = FetchType.EAGER)
public List<Section> sections;

方案3：禁止序列化sections字段 #

如果接口不需要返回sections信息，直接给字段加@JsonIgnore注解跳过序列化即可：

@JsonIgnore
@OneToMany(mappedBy = "template", cascade = CascadeType.ALL)
public List<Section> sections;

补充检查项 #

双向关联场景下需要确认Section实体中已正确配置反向关联：

@Entity
public class Section extends PanacheEntity {
    @ManyToOne
    public Template template;
    // 其他字段
}

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