Spring Boot JPA更新OneToMany多端实体后从一端关联列表消失问题

该问题由三个核心问题共同导致：

• 双向关联未手动维护一致性：JPA双向关联无自动同步机制，更新Patient时既没有给Patient设置正确的Doctor引用，也没有将更新后的Patient同步到对应Doctor的patients集合中，Hibernate不会自动完成内存对象的同步。
• 接口逻辑与JSON注解配合缺陷：@JsonBackReference标注在Patient的doctor属性上，前端传参反序列化时doctor字段会被直接忽略。原有update接口直接给前端传参得到的Patient对象setId就执行save，此时拿到的Patient对象doctor属性实际为null，会直接导致关联关系丢失；同时@ManyToOne上错误配置的CascadeType.ALL，极端场景下会级联删除关联的Doctor数据。
• 持久化上下文快照不同步：原有逻辑直接保存游离对象，Hibernate不会自动更新一级缓存中已加载的Doctor实体的patients集合快照，查询Doctor时拿到的是旧集合数据，自然看不到更新后的Patient。

1. 修正实体关联注解配置 #

调整两个实体的级联配置，将级联操作放到「一」的一侧（Doctor侧），去掉多端不合理的全级联配置，同时初始化集合避免空指针：

// Doctor实体修正
@Data
@AllArgsConstructor
@NoArgsConstructor
@Entity
public class Doctor {

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

    @NotBlank
    private String name;

    // 级联配置放到一的一侧，禁止在多端配置CascadeType.ALL
    @OneToMany(mappedBy = "doctor", cascade = {CascadeType.PERSIST, CascadeType.MERGE}, orphanRemoval = false)
    @JsonManagedReference
    private List<Patient> patients = new ArrayList<>();
}

// Patient实体修正
@Data
@AllArgsConstructor
@NoArgsConstructor
@Entity
public class Patient {

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

    @NotBlank
    private String name;

    @Range(min=1, max=150)
    private int age;

    // 移除错误的CascadeType.ALL配置，操作患者不应级联联动医生数据
    @ManyToOne
    @JoinColumn(name = "doctor_id")
    @JsonBackReference
    private Doctor doctor;

    @OneToOne
    private Receipt receipt;

    // 新增专用字段接收前端传的医生ID，不直接依赖关联属性做反序列化
    @JsonProperty(access = JsonProperty.Access.WRITE_ONLY)
    private Long doctorId;
}

2. 重写更新逻辑，手动维护双向关联 #

禁止直接用前端反序列化得到的游离对象setId就保存，正确逻辑需要先查询数据库中已有的托管状态实体，同步普通字段和关联关系：

// Service层更新方法示例，Service类必须加@Transactional注解
@Transactional
public void updatePatient(Long id, Patient patientParam) {
    // 1. 查询数据库中已存在的托管状态Patient
    Patient existingPatient = patientRepository.findById(id)
            .orElseThrow(() -> new RuntimeException("患者不存在"));
    
    // 2. 同步普通可修改字段
    existingPatient.setName(patientParam.getName());
    existingPatient.setAge(patientParam.getAge());
    existingPatient.setReceipt(patientParam.getReceipt());

    // 3. 处理医生关联变更
    Long newDoctorId = patientParam.getDoctorId();
    if (newDoctorId != null) {
        // 如果之前绑定过旧医生，先将患者从旧医生的集合中移除
        Doctor oldDoctor = existingPatient.getDoctor();
        if (oldDoctor != null && !oldDoctor.getId().equals(newDoctorId)) {
            oldDoctor.getPatients().remove(existingPatient);
        }
        // 查询新绑定的医生，手动维护双向关联
        Doctor newDoctor = doctorRepository.findById(newDoctorId)
                .orElseThrow(() -> new RuntimeException("医生不存在"));
        existingPatient.setDoctor(newDoctor);
        // 必须手动将患者加到新医生的patients集合，保证内存中对象引用一致
        newDoctor.getPatients().add(existingPatient);
    }

    // 4. 保存托管对象，Hibernate自动同步数据库状态
    patientRepository.save(existingPatient);
}

// Controller层Put接口修正
@PutMapping("/{id}")
public void updatePatientById(@PathVariable Long id, @RequestBody Patient patient) {
    patientService.updatePatient(id, patient);
}

3. 注意事项 #

• 所有涉及双向关联的增、删、改操作，都必须手动同步双方的引用关系，Hibernate不会自动维护内存中的对象关联。新增Patient时也需要遵循同样的关联维护逻辑，否则会出现相同的列表缺失问题。
• Service层的增删改方法必须加@Transactional注解，保证所有操作在同一个持久化上下文中完成，避免一级缓存快照不一致的问题。
• 禁止在@ManyToOne多端配置CascadeType.ALL，该配置包含REMOVE级联，会导致删除患者时连带删除关联的医生，完全不符合常规业务逻辑。

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