List转Set致顺序异常？MapStruct映射DTO到实体问题排查

我正在创建证书，需要保留用户设置的过境国家顺序，但部分场景下国家会随机排序。排查日志发现顺序在DTO转实体时发生变化，所有映射使用MapStruct库，怀疑countryDTOListToCountrySet方法存在问题。想确认两个点：

1. List转Set是否会导致顺序混乱？
2. 若不是，该如何查看MapStruct生成的映射类日志，排查DTO转实体的每一步过程？

相关代码 #

实体字段：

private Set<Country> transitCountries = new HashSet<>();

DTO字段：

private List<CountryDTO> transitCountries;

两个类均使用Lombok的@Data注解。

MapStruct生成的代码如下：

protected Set<Country> countryDTOListToCountrySet(List<CountryDTO> list) {
        if ( list == null ) {
            return null;
        }

        Set<Country> set = new HashSet<Country>( Math.max( (int) ( list.size() / .75f ) + 1, 16 ) );
        for ( CountryDTO countryDTO : list ) {
            set.add( countryDTOToCountry( countryDTO ) );
        }

        return set;
    }

我尝试将HashSet改为LinkedHashSet，但似乎没有效果，不确定是否和Lombok有关。

1. List转Set是否会导致顺序混乱？ #

是的，HashSet本身是无序的，它不保证元素的存储和遍历顺序与插入顺序一致——你看到的MapStruct生成代码里用的正是HashSet，这就是顺序混乱的核心原因。

你改成LinkedHashSet没效果，是因为MapStruct会在编译时自动重新生成映射实现类，手动修改生成的代码会被覆盖，和Lombok无关。要让MapStruct默认用LinkedHashSet，得通过配置实现：

• 局部配置：在映射方法上自定义集合转换逻辑

@Mapping(target = "transitCountries", qualifiedByName = "toLinkedHashSet")
YourEntity dtoToEntity(YourDTO dto);

@Named("toLinkedHashSet")
default Set<Country> convertToLinkedHashSet(List<CountryDTO> dtos) {
    return dtos.stream()
        .map(this::countryDTOToCountry)
        .collect(Collectors.toCollection(LinkedHashSet::new));
}

• 全局配置：在Spring项目的application.properties中添加：

mapstruct.default-set-type=java.util.LinkedHashSet

或者给映射接口添加全局配置类：

@MapperConfig(defaultSetType = LinkedHashSet.class)
public interface MapperGlobalConfig {}

@Mapper(config = MapperGlobalConfig.class)
public interface YourMapper {}

2. 如何查看MapStruct映射的细节？ #

直接查看生成的代码 #

MapStruct生成的实现类默认存放在target/generated-sources/annotations目录（Maven项目），直接打开对应类就能看到完整的映射逻辑，不需要日志就能排查每一步转换过程。

打印运行时日志 #

如果需要跟踪运行时的映射过程：

1. 开启MapStruct调试日志：在日志配置（如logback.xml）中把org.mapstruct的日志级别设为DEBUG：

<logger name="org.mapstruct" level="DEBUG"/>

会输出MapStruct的初始化、方法调用等细节日志。
2. 自定义映射方法加日志：在映射接口中手动实现部分方法，添加日志打印转换前后的顺序：

@Override
public YourEntity dtoToEntity(YourDTO dto) {
    if (dto == null) return null;
    YourEntity entity = new YourEntity();
    
    // 打印DTO中的国家顺序
    System.out.println("DTO transit countries: " + dto.getTransitCountries().stream().map(CountryDTO::getCode).toList());
    Set<Country> converted = convertToLinkedHashSet(dto.getTransitCountries());
    // 打印转换后的实体国家顺序
    System.out.println("Entity transit countries: " + converted.stream().map(Country::getCode).toList());
    
    entity.setTransitCountries(converted);
    // 其他字段映射
    return entity;
}

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