如何用ModelMapper正确更新托管实体的子实体引用？

你遇到的报错是因为托管状态下的实体不允许修改主键：
从数据库加载Student后，它处于Hibernate的持久化上下文（托管状态），由于Dormitory是即时加载（FetchType.EAGER），关联的Dormitory实例同样是托管状态。此时用ModelMapper直接修改这个托管Dormitory的dormitoryID，Hibernate会认为你要修改该Dormitory实体在数据库中的主键，这违反了JPA规范——主键作为实体的唯一标识，托管状态下不允许被修改。

你之前先把dormitory置空再映射的方法之所以能生效，是因为ModelMapper会创建一个非托管状态的新Dormitory实例，修改这个新实例的ID不会触发Hibernate的主键校验，最终Hibernate只会更新Student的外键关联，而非修改Dormitory的主键。但这种写法确实不够优雅，也容易引发其他问题。

核心思路是：不要修改现有托管Dormitory的ID，而是直接给Student设置一个新的Dormitory实例（或代理对象），让Hibernate只处理外键关联的更新。

方案1：用ModelConverter实现ID到实体的转换 #

修改ModelMapper的配置，添加转换器，把DTO中的dormitoryID直接转换成Dormitory代理对象，避免修改现有托管实体的ID：

@Configuration
public class ModelMapperConfig {

    @Autowired
    private EntityManager entityManager;

    @Bean
    public ModelMapper modelMapper() {
        ModelMapper modelMapper = new ModelMapper();
        modelMapper.getConfiguration().setDeepCopyEnabled(true);

        // 配置转换器：将Long类型的宿舍ID转为Dormitory代理对象（无需查询数据库）
        Converter<Long, Dormitory> dormitoryConverter = context -> {
            Long dormId = context.getSource();
            if (dormId == null) {
                return null;
            }
            // 使用getReference创建代理，避免额外DB查询，仅用于关联外键
            return entityManager.getReference(Dormitory.class, dormId);
        };

        modelMapper.addConverter(dormitoryConverter);

        // 配置属性映射：直接将DTO的dormitoryID映射为Student的dormitory属性
        PropertyMap<StudentDTO, Student> studentMap = new PropertyMap<StudentDTO, Student>() {
            @Override
            protected void configure() {
                map(source.getDormitoryID(), destination.getDormitory());
            }
        };

        modelMapper.addMappings(studentMap);
        return modelMapper;
    }
}

然后修改Service实现，去掉置空dormitory的代码：

@Service
public class StudentServiceImpl implements StudentService {
 
    @Autowired
    private StudentRepository studentRepo;

    @Autowired
    private ModelMapper modelMapper;

    @Override
    public void updateStudent(StudentDTO studentDTO) {
        Student studentToUpdate = studentRepo.findById(studentDTO.getStudentID())
                .orElseThrow(() -> new IllegalArgumentException("Student not found with ID: " + studentDTO.getStudentID()));
        
        // 直接映射，无需手动置空
        modelMapper.map(studentDTO, studentToUpdate);
        studentRepo.saveAndFlush(studentToUpdate);
    }
}

方案2：手动处理关联关系（适合简单场景） #

如果不想修改ModelMapper配置，也可以在Service中手动判断并替换Dormitory实例：

@Service
public class StudentServiceImpl implements StudentService {
 
    @Autowired
    private StudentRepository studentRepo;

    @Autowired
    private ModelMapper modelMapper;

    @Autowired
    private EntityManager entityManager;

    @Override
    public void updateStudent(StudentDTO studentDTO) {
        Student studentToUpdate = studentRepo.findById(studentDTO.getStudentID())
                .orElseThrow(() -> new IllegalArgumentException("Student not found with ID: " + studentDTO.getStudentID()));
        
        Long newDormId = studentDTO.getDormitoryID();
        Dormitory currentDorm = studentToUpdate.getDormitory();

        // 仅当宿舍ID发生变化时，替换为新的Dormitory代理对象
        if ((currentDorm == null && newDormId != null) 
            || (currentDorm != null && !currentDorm.getDormitoryID().equals(newDormId))) {
            Dormitory newDorm = entityManager.getReference(Dormitory.class, newDormId);
            studentToUpdate.setDormitory(newDorm);
        }

        // 映射其他属性
        modelMapper.map(studentDTO, studentToUpdate);
        studentRepo.saveAndFlush(studentToUpdate);
    }
}

• 使用EntityManager.getReference()比直接创建Dormitory实例更高效：它只会创建一个代理对象，不会触发数据库查询，适合仅需关联外键的场景。
• 托管状态的实体是Hibernate持久化上下文的一部分，任何对其主键的修改都会被Hibernate视为要更新数据库中的主键记录，这是不被允许的，因此必须避免直接修改托管实体的ID。

内容的提问来源于stack exchange，提问作者Ed R.