SpringBoot @OneToMany关联触发问题及请求传参异常处理

1. 用DTO解耦请求参数与实体 #

不要直接用Employee实体接收请求，定义一个专门的创建DTO，将部门字段改为ID类型：

@Data
public class EmployeeCreateDTO {
    private String employeeName;
    private String employeeSurname;
    private String employeeEmail;
    private String employeeIdentityNumber;
    private Long departmentId; // 仅传递部门ID
}

2. 业务层维护双向关联 #

在创建员工的Service方法中，完成部门查询、关联关系绑定：

@Service
@Transactional
public class EmployeeService {

    @Autowired
    private EmployeeRepository employeeRepo;
    @Autowired
    private DepartmentRepository deptRepo;

    public Employee createEmployee(EmployeeCreateDTO dto) {
        // 1. 查询持久态部门对象
        Department department = deptRepo.findById(dto.getDepartmentId())
                .orElseThrow(() -> new RuntimeException("指定部门不存在"));
        
        // 2. 构建员工实体并绑定部门
        Employee employee = Employee.builder()
                .employeeName(dto.getEmployeeName())
                .employeeSurname(dto.getEmployeeSurname())
                .employeeEmail(dto.getEmployeeEmail())
                .employeeIdentityNumber(dto.getEmployeeIdentityNumber())
                .department(department)
                .build();
        
        // 3. 维护双向关联：将员工添加到部门的员工集合
        if (department.getEmployees() == null) {
            department.setEmployees(new HashSet<>());
        }
        department.getEmployees().add(employee);
        
        // 4. 保存员工，事务提交时自动同步部门的员工集合更新
        return employeeRepo.save(employee);
    }
}

3. 控制器适配DTO #

控制器接收DTO参数，调用业务层方法：

@RestController
@RequestMapping("/employees")
public class EmployeeController {

    @Autowired
    private EmployeeService employeeService;

    @PostMapping
    public ResponseEntity<Employee> createEmployee(@RequestBody EmployeeCreateDTO dto) {
        Employee createdEmployee = employeeService.createEmployee(dto);
        return ResponseEntity.ok(createdEmployee);
    }
}

关键注意事项 #

• 必须在事务中执行操作：持久态的Department对象修改集合后，事务提交时Hibernate会自动同步到数据库。
• 提前初始化部门的employees集合，避免空指针异常。
• 双向关联中@OneToMany(mappedBy = "department")指定Employee是关联维护端，保存员工会自动更新外键，但部门的员工集合需要手动添加才能同步。

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