Spring Boot中ModelMapper一对多映射报错：PersistentSet无法转Set

核心问题原因 #

Hibernate的PersistentSet是java.util.Set的实现类，但它是Hibernate用于懒加载、缓存管理的内部集合类型。当ModelMapper默认映射逻辑遇到未初始化的懒加载集合，或者类型匹配策略不够宽松时，就会抛出转换异常。

可行解决方案 #

1. 配置ModelMapper支持Hibernate集合类型

创建ModelMapper配置类，添加自定义转换器并调整匹配策略：

@Configuration
public class ModelMapperConfig {
    @Bean
    public ModelMapper modelMapper() {
        ModelMapper modelMapper = new ModelMapper();
        // 设置宽松匹配策略，允许子类型向父类型转换
        modelMapper.getConfiguration().setMatchingStrategy(MatchingStrategies.LOOSE);
        // 添加PersistentSet到Set的转换器
        modelMapper.addConverter(new Converter<PersistentSet<?>, Set<?>>() {
            @Override
            public Set<?> convert(MappingContext<PersistentSet<?>, Set<?>> context) {
                PersistentSet<?> source = context.getSource();
                return source != null ? new HashSet<>(source) : Collections.emptySet();
            }
        });
        return modelMapper;
    }
}

2. 提前初始化懒加载集合

如果实体中的modelos是懒加载的（默认@OneToMany为懒加载），在Service层映射前手动触发集合初始化：

@Service
public class EquipamentoMarcaService {
    @Autowired
    private EquipamentoMarcaRepository repository;
    @Autowired
    private ModelMapper modelMapper;

    public List<EquipamentoMarcaDto> getAllMarcas() {
        List<EquipamentoMarca> marcas = repository.findAll();
        // 初始化每个品牌的型号集合，避免懒加载代理问题
        marcas.forEach(marca -> Hibernate.initialize(marca.getModelos()));
        return marcas.stream()
                .map(marca -> modelMapper.map(marca, EquipamentoMarcaDto.class))
                .collect(Collectors.toList());
    }
}

3. 自定义TypeMap映射规则

针对特定实体和DTO创建TypeMap，明确集合的转换逻辑：

@Configuration
public class ModelMapperConfig {
    @Bean
    public ModelMapper modelMapper() {
        ModelMapper modelMapper = new ModelMapper();
        // 自定义品牌到DTO的映射，显式转换集合类型
        TypeMap<EquipamentoMarca, EquipamentoMarcaDto> marcaMap = 
            modelMapper.createTypeMap(EquipamentoMarca.class, EquipamentoMarcaDto.class);
        marcaMap.addMappings(mapper -> 
            mapper.map(src -> new HashSet<>(src.getModelos()), EquipamentoMarcaDto::setModelos)
        );
        // 配置型号实体到DTO的映射
        modelMapper.createTypeMap(EquipamentoModelo.class, EquipamentoModeloDto.class);
        return modelMapper;
    }
}

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