MapStruct将单元素List映射为单个对象遇类型转换问题求助

核心问题拆解 #

你的问题本质是两个点：

1. 源List中的OrderInvoice与目标OrderInvoice属于不同包的类，直接赋值会触发类型不兼容错误
2. MapStruct需要明确的规则将List转换为单个对象，不过嵌套List的元素类型一致，MapStruct可自动完成这部分映射

正确实现方案 #

在你的MapStruct接口中按以下步骤定义映射规则：

1. 定义单个对象的跨包映射方法
   先实现不同包OrderInvoice的转换，MapStruct会自动处理嵌套的List结构（只要嵌套元素类型完全一致）：

// 源类型：com.sams.oms.ng.common.models.payment.request.OrderInvoice
// 目标类型：com.sams.oms.ng.common.models.payment.cosmos.OrderInvoice
com.sams.oms.ng.common.models.payment.cosmos.OrderInvoice toCosmosOrderInvoice(com.sams.oms.ng.common.models.payment.request.OrderInvoice source);

2. 添加List转单个目标对象的默认方法
   写一个默认方法，负责从List中取第一个元素，并调用上面的单个对象映射：

@Named("listToSingleOrderInvoice")
default com.sams.oms.ng.common.models.payment.cosmos.OrderInvoice listToSingleOrderInvoice(List<com.sams.oms.ng.common.models.payment.request.OrderInvoice> sourceList) {
    if (sourceList == null || sourceList.isEmpty()) {
        return null;
    }
    return toCosmosOrderInvoice(sourceList.get(0));
}

3. 主映射方法关联自定义转换
   在主映射的@Mapping注解中，通过qualifiedByName指定使用上述自定义方法：

@Mapping(target = "orderInvoice", 
         source = "basePaymentRequest.invoice.eventPayload.orderInvoices",
         qualifiedByName = "listToSingleOrderInvoice")
ChargeTransaction createInvoiceCTMapper(PaymentTriggerBaseModel basePaymentRequest, ChargeType chargeType);

简化替代方案 #

如果不想用qualifiedByName，也可以直接在expression中调用自定义默认方法，同样能完成类型转换：

@Mapping(target = "orderInvoice", 
         expression = "java(listToSingleOrderInvoice(basePaymentRequest.invoice.eventPayload.orderInvoices))")
ChargeTransaction createInvoiceCTMapper(PaymentTriggerBaseModel basePaymentRequest, ChargeType chargeType);

之前尝试失败的原因 #

• 第一次直接映射List到单个对象：MapStruct缺乏List转单个对象的明确规则，无法自动推断
• 第二次直接调用get(0)：获取到的是源包的OrderInvoice，没有经过MapStruct的跨包类型转换，导致类型不兼容

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