Spring Boot JPA新增Department时遇employee_id无默认值错误求助

问题原因 #

1. 实体类字段命名错误：Department实体中，把关联Employee集合的字段命名为employee_id，Hibernate误将其识别为普通字段，在department_表中生成了非空的employee_id列，但该列无默认值，插入部门时因未传值触发报错。而实际上双向OneToMany关联中，部门作为被维护方，不需要在自身表中存储员工相关列。
2. 无效的请求参数：创建部门时传递employee_id是错误的，一是该字段被@JsonIgnore标记不会被反序列化，二是双向关联的维护权在Employee（外键department_id在Employee表），部门无法直接通过接收员工ID来关联。
3. 不必要的默认初始化：Employee实体中默认new Department()会导致未关联部门的员工被绑定到空部门实例，可能引发额外的持久化异常。

解决方案 #

1. 修正Department实体的关联字段 #

将集合字段名改为语义化的employees，明确这是员工集合，避免Hibernate映射错误：

@Entity
@Table(name = "department_")
@Getter
@Setter
@EqualsAndHashCode(onlyExplicitlyIncluded = true)
@NoArgsConstructor
public class Department implements Serializable {

    @EqualsAndHashCode.Include
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    @JsonIgnore
    @OneToMany(mappedBy = "department")
    private List<Employee> employees; // 修正字段名
}

2. 清理数据库表结构 #

删除department_表中错误生成的employee_id列；若使用Hibernate自动建表（spring.jpa.hibernate.ddl-auto设为update或create），修正实体后重启应用即可自动调整表结构。

3. 调整创建部门的请求参数 #

创建部门仅需传递部门名称，无需员工ID：

{
    "name": "Test"
}

若要关联已有员工，需通过更新员工接口，设置员工的department_id来完成关联（因为Employee是关联维护方）。

4. 修正Employee实体的默认初始化 #

移除department字段的默认实例化，避免空部门被意外创建：

@EqualsAndHashCode(onlyExplicitlyIncluded = true)
@NoArgsConstructor
@Setter
@Getter
@Entity
@Table(name = "employee_")
public class Employee implements Serializable {
    @EqualsAndHashCode.Include
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;

    @ManyToOne
    @JoinColumn(name = "department_id")
    private Department department; // 移除默认new Department()
}

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