Spring Boot+Hibernate POST请求无法存储OneToMany关联的嵌套对象列表

问题成因 #

• 实体类缺失Getter/Setter方法：Jackson反序列化JSON时无法给嵌套的DefaultGroup属性赋值，序列化返回时也无法读取DefaultGroup的字段值，导致返回空对象。
• 关联配置不规范：当前@OneToMany是单向关联且未配置mappedBy，默认生成中间表，部分场景下会导致级联存储异常。
• 懒加载序列化问题：FetchType.LAZY配置下，查询时如果没有开启事务或相关序列化配置，会导致关联属性加载异常。
• 字段命名不匹配：如果实体类属性命名和JSON键名不一致，且没有配置映射规则，会导致反序列化时字段赋值失败。

排查步骤 #

• 先在控制器createCompania方法入口打断点，查看@RequestBody接收到的compania对象中default_group列表内的元素是否有name、path值：如果此处为空，属于JSON反序列化问题；如果此处有值，属于存储或查询序列化问题。
• 若控制器接收参数正常，直接查询数据库中default_group表的数据，确认name、path字段是否正常存储：如果数据库有值，属于返回序列化问题；如果数据库为空，属于JPA级联存储问题。
• 检查Compania、DefaultGroup、Office三个实体类是否有public权限的Getter、Setter方法。

解决方案 #

1. 补全实体类的Getter/Setter
   可以手动为每个属性添加get/set方法，也可以引入Lombok依赖后在实体类上添加@Data注解，自动生成Getter、Setter、toString等通用方法，示例：

@Data
@Entity
@Table
public class DefaultGroup {
    // 原有属性不变
}

2. 优化关联配置（推荐）
   单向OneToMany默认生成中间表，可改为双向关联减少冗余表：
   第一步在DefaultGroup类中添加上级关联属性：

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "compania_id")
private Compania compania;

第二步修改Compania类中@OneToMany的配置，添加mappedBy属性：

@OneToMany(
        cascade = CascadeType.ALL,
        fetch = FetchType.LAZY,
        orphanRemoval = true,
        mappedBy = "compania"
)
private List<DefaultGroup> default_group;

存储数据时需要手动给每个DefaultGroup对象设置compania属性，避免外键为空。
3. 解决懒加载序列化问题
如果是查询返回时序列化异常，可选择以下任意一种方案：

• 在查询接口对应的业务方法上添加@Transactional注解，保持Session在序列化阶段处于打开状态
• 将@OneToMany的fetch属性改为FetchType.EAGER（小数据量场景适用）
• 引入Hibernate Jackson模块，配置支持懒加载属性序列化

4. 字段名映射配置
   如果后续调整实体类属性为Java规范的小驼峰命名（如defaultGroup），和JSON的下划线命名不匹配时，可在application.yml中添加全局配置：

spring:
  jackson:
    property-naming-strategy: SNAKE_CASE

也可以在对应属性上添加@JsonProperty("default_group")注解单独指定映射关系。

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