Hibernate配置OneToMany一对多关联查询时关联集合返回null如何解决

常见原因1：@OneToMany默认懒加载未初始化 #

@OneToMany注解默认的fetch策略为FetchType.LAZY，如果查询完成后Session已经关闭，未初始化的懒加载集合就会出现null值，部分场景还会抛出LazyInitializationException异常。
对应解决方法二选一：

• 调整关联注解的加载策略为立即加载，修改SmsConfig的@OneToMany注解：

// 加上fetch属性配置为立即加载
@OneToMany(mappedBy  = "smsConfig", fetch = FetchType.EAGER)
private List<Param> param = new ArrayList<>();

• 不修改全局加载策略，查询时使用JPQL的fetch join主动关联加载集合：

// 示例JPQL，查询时主动关联拉取param集合
@Query("SELECT sc FROM SmsConfig sc LEFT JOIN FETCH sc.param WHERE sc.id = :id")
SmsConfig findOneWithParams(@Param("id") Long id);

常见原因2：双向关联关系未正确维护 #

双向一对多关联需要同时维护两端的关联关系，如果仅设置了Param实体的smsConfig属性，没有将Param对象加入SmsConfig的param集合，同Session内查询时会因为一级缓存的存在，获取到未更新集合的SmsConfig对象。
建议在SmsConfig实体中新增关联维护方法，保存数据时调用该方法设置关联：

public void addParam(Param param) {
    this.param.add(param);
    param.setSmsConfig(this);
}

常见原因3：序列化场景丢失懒加载数据 #

如果查询后需要经过序列化（比如接口返回JSON），懒加载的代理集合在未初始化的情况下会被序列化框架处理为null。
对应解决方法：

• 序列化前主动初始化集合：Hibernate.initialize(smsConfig.getParam());
• 适配序列化框架的Hibernate懒加载支持，比如Jackson引入jackson-datatype-hibernate模块自动处理懒加载属性。

常见原因4：数据库数据异常 #

检查param表的sms_config_id外键字段是否存在与查询的SmsConfig主键匹配的值，外键值为空或不匹配也会返回空集合/ null。

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