JPA @OneToMany关联保存时address表employee_id为null的解决方法

问题场景 #

使用Spring Boot JPA开发实体关联时，通过Post接口批量保存Employee数据，Address表的外键employee_id始终为null，其他字段正常保存。

相关代码 #

Controller类

@PostMapping("employees")
public ResponseEntity<List<Employee>> createEmployees(@RequestBody List<Employee> employee) {
    List<Employee> newUsers = new ArrayList<>();
    for(Employee emp : employee){
        Employee newUser = employeeRepository.save(emp);
        newUsers.add(newUser);
    }
    return ResponseEntity.ok(newUsers);
}

Employee实体类

@Entity
@Table(name = "employee")
@JsonInclude(JsonInclude.Include.NON_NULL)
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Employee {

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

    private String name;

    private double salary;

    private String position;

    @OneToMany(cascade = CascadeType.ALL, mappedBy = "employee")
    private List<Address> addresses;
}

Address实体类

@Entity
@Table(name = "address")
@Data
@JsonInclude(JsonInclude.Include.NON_NULL)
@NoArgsConstructor
@AllArgsConstructor
public class Address {

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

    private String street;

    private String city;

    private String state;

    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name = "employee_id")
    private Employee employee;
}

请求Payload

[{
    "name": "test-user433242",
    "salary": "94457020",
    "position": "developer-244332",
        "addresses": [
            {         
               "street": "Ne22w st 444331",
                "city": "Ne22w york city 443321",
               "state": "N22ew york state 43321"
             },
             {         
               "street": "texas st 211332",
               "city": "texas city 22332",
               "state": "texas state 23332"   
             }
    ]
},
{
    "name": "test-user2133323",
    "salary": "94777030",
    "position": "developer33-21332",
        "addresses": [
            {         
               "street": "New3 st 211332",
               "city": "New york city 22332",
               "state": "Ne33w york state 23332"   
             },
             {         
               "street": "buffaol st 211332",
               "city": "buffalo city 22332",
               "state": "buffalo state 23332"   
             }
    ]
}]

问题详情 #

已配置JPA的@OneToMany关联并设置CascadeType.ALL，理论上保存Employee时应级联保存关联的Address并自动填充外键，但实际保存后Address表的employee_id字段为null。如何正确保存包含关联Address的Employee数据？

解决方案 #

问题核心是双向关联的维护端未绑定关联关系：JPA中@OneToMany(mappedBy = "employee")标记Employee为关联的非维护端，Address作为@ManyToOne的拥有者是维护端，外键employee_id由Address对象的employee属性控制。前端传入的数据中，Address的employee属性为null，所以保存时外键不会自动填充。

方法1：在Employee实体中自动绑定关联 #

重写setAddresses方法，在设置地址列表时自动绑定当前Employee到每个Address：

@Entity
@Table(name = "employee")
@JsonInclude(JsonInclude.Include.NON_NULL)
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Employee {
    // 原有字段不变...

    @OneToMany(cascade = CascadeType.ALL, mappedBy = "employee")
    private List<Address> addresses;

    // 覆盖Lombok自动生成的setter，绑定关联关系
    public void setAddresses(List<Address> addresses) {
        this.addresses = addresses;
        if (addresses != null) {
            addresses.forEach(address -> address.setEmployee(this));
        }
    }
}

方法2：在Controller中手动绑定关联 #

如果不想修改实体类，可在保存前手动为每个Address绑定对应的Employee：

@PostMapping("employees")
public ResponseEntity<List<Employee>> createEmployees(@RequestBody List<Employee> employees) {
    List<Employee> newUsers = new ArrayList<>();
    for(Employee emp : employees){
        if (emp.getAddresses() != null) {
            // 绑定每个地址到当前员工
            emp.getAddresses().forEach(address -> address.setEmployee(emp));
        }
        Employee newUser = employeeRepository.save(emp);
        newUsers.add(newUser);
    }
    return ResponseEntity.ok(newUsers);
}

注意事项 #

• 双向关联必须确保维护端（Address）的employee属性被正确赋值，JPA才会自动填充外键。
• 使用Lombok的@Data时，默认生成的setAddresses不会处理关联绑定，必须手动重写覆盖。
• 批量保存时，每个Employee对应的所有Address都要完成绑定，否则外键依然为null。

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