如何解决MapStruct无法为XJC(JAXB)生成的无集合setter类生成映射器问题

解决方案 #

1. 修正集合映射策略配置 #

你当前使用的CollectionMappingStrategy.TARGET_IMMUTABLE不匹配XJC生成类的特性，XJC生成的集合属性属于延迟初始化、仅通过getter暴露可变实例的模式，需要替换为CollectionMappingStrategy.ACCESSOR_ONLY策略。该策略会让MapStruct优先通过getter获取目标集合实例，直接调用集合的add/clear等方法完成元素映射，不需要依赖setter或adder方法。
修改后的Mapper注解如下：

@Mapper(
    collectionMappingStrategy = CollectionMappingStrategy.ACCESSOR_ONLY,
    uses = {AddressTypeMapper.class, PensionTypeMapper.class}, // 补充所有用到的子集合映射器
    unmappedTargetPolicy = ReportingPolicy.IGNORE,
    componentModel = "spring"
)
public interface IndividualTypeMapper {
    IndividualType toIndividualType(IndividualEntity individual);
    @InheritInverseConfiguration
    IndividualEntity fromIndividualType(IndividualType individualType);
}

2. 显式指定集合属性映射（可选，适配属性名不一致场景） #

如果你的IndividualEntity中集合属性名和JAXB类中的集合属性名不完全一致，需要通过@Mapping注解显式指定对应关系，避免MapStruct识别不到映射规则：

@Mapping(target = "addressTypes", source = "addressList")
@Mapping(target = "pensionTypes", source = "pensionList")
IndividualType toIndividualType(IndividualEntity individual);

3. 验证MapStruct版本 #

确保你使用的MapStruct版本在1.3.1.Final及以上，低版本对ACCESSOR_ONLY策略的支持存在缺陷，会出现集合映射逻辑缺失的问题。推荐升级到1.5.5.Final或更高的稳定版本，兼容性更好。

4. 强制重新编译项目 #

修改配置后需要执行mvn clean compile（Gradle项目执行gradle clean compileJava）清除旧的生成类，让MapStruct重新生成映射代码，修改后的生成代码会自动包含集合映射逻辑，示例如下：

@Override
public IndividualType toIndividualType(IndividualEntity individual) {
    if ( individual == null ) {
        return null;
    }
    IndividualType individualType = new IndividualType();
    individualType.setFirstName( individual.getFirstName() );
    // 自动生成的集合映射逻辑
    if ( individual.getAddressList() != null ) {
        individualType.getAddressTypes().addAll( addressTypeMapper.toAddressTypeList( individual.getAddressList() ) );
    }
    if ( individual.getPensionList() != null ) {
        individualType.getPensionTypes().addAll( pensionTypeMapper.toPensionTypeList( individual.getPensionList() ) );
    }
    return individualType;
}

特殊情况处理 #

如果上述配置依然不生效，可以通过@AfterMapping注解补充自定义映射逻辑，不需要完全手动实现整个映射：

@AfterMapping
default void fillCollection(@MappingTarget IndividualType target, IndividualEntity source) {
    if (source.getAddressList() != null) {
        target.getAddressTypes().addAll(addressTypeMapper.toAddressTypeList(source.getAddressList()));
    }
    // 其他集合映射同理
}

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