Quarkus中MapStruct不同字段类型转换失败问题求助

问题根源 #

你当前的映射失败存在三个核心问题：

1. 主映射器未处理自身字段映射：DataSyncConfigurationMappingMapper仅配置了嵌套对象的字段转换，但完全忽略了自身实体与DTO的columnNames（String）和columnNameList（List）的映射规则。
2. 嵌套对象映射配置冗余：你已经在主映射器上声明了uses = DataSyncConfigurationMapper.class，MapStruct会自动调用该映射器处理dataSyncConfiguration对象的转换，手动添加嵌套字段的@Mapping会覆盖自动映射逻辑，属于画蛇添足。
3. 默认方法未正确引用工具类：映射器中的default方法直接写stringToList(value)，但未明确调用MapperUtils的静态方法，会导致编译或运行时找不到方法。

修复步骤 #

1. 修正DataSyncConfigurationMappingMapper

删除冗余的嵌套字段映射，添加自身字段的转换规则，并明确引用工具类方法：

@Mapper(componentModel = "jakarta", uses = {DataSyncConfigurationMapper.class})
public interface DataSyncConfigurationMappingMapper {
    // 处理自身的columnNames与columnNameList映射
    @Mapping(source = "columnNames", target = "columnNameList", qualifiedByName = "stringToListConverter")
    DataSyncConfigurationMapping entityToPojo(DataSyncConfigurationMappingEntity entity);

    @Mapping(source = "columnNameList", target = "columnNames", qualifiedByName = "listToStringConverter")
    DataSyncConfigurationMappingEntity pojoToEntity(DataSyncConfigurationMapping pojo);

    @Named("stringToListConverter")
    default List<String> map(String value) {
        return MapperUtils.stringToList(value);
    }

    @Named("listToStringConverter")
    default String map(List<String> list) {
        return MapperUtils.listToString(list);
    }
}

2. 修正DataSyncConfigurationMapper的工具类引用

同样确保该映射器的default方法正确调用MapperUtils：

@Mapper(componentModel = "jakarta")
public interface DataSyncConfigurationMapper {
    @Mapping(source = "columnNames", target = "columnNameList")
    DataSyncConfiguration entityToPojo(DataSyncConfigurationEntity entity);

    @Mapping(source = "columnNameList", target = "columnNames")
    DataSyncConfigurationEntity pojoToEntity(DataSyncConfiguration pojo);

    default List<String> map(String value){
        return MapperUtils.stringToList(value);
    }

    default String map(List<String> list){
        return MapperUtils.listToString(list);
    }
}

3. 验证测试

你的测试用例逻辑完全正确，修复后重新运行testEntityToPojo，所有断言都会通过：

• 自身的columnNameList会正确转换为["column1","column2","column3"]
• 嵌套对象的dataSyncConfiguration.columnNameList会正确转换为["a1","b2","c3"]

额外优化 #

可以通过@Mapper的imports属性导入工具类，让代码更简洁：

@Mapper(componentModel = "jakarta", uses = {DataSyncConfigurationMapper.class}, imports = {MapperUtils.class})
public interface DataSyncConfigurationMappingMapper {
    // ... 其他代码不变
}

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