针对相同目标的多个命名MapStruct AfterMappings方法无法被调用问题

问题根因 #

你当前写法的核心问题是@BeanMapping注解仅作用于单实体映射场景，集合类批量映射的配置无法通过@BeanMapping匹配到集合级别的@AfterMapping后置处理方法，所以两个排序方法都不会触发。

修复方案 #

方案1（适配MapStruct 1.4.2及以上版本，最简修改） #

将集合映射方法上的@BeanMapping替换为@IterableMapping即可，该注解专门用于配置集合/迭代类型的映射规则，可正确匹配到集合级别的带限定符后置方法：

@Mapper(componentModel = "spring")
public abstract class NotificationMapper {
    // ... 自动注入的服务、单个对象映射逻辑保持不变
    public abstract IssueNotificationResponse notificationToIssueResponse(Notification notification);
    
    @IterableMapping(qualifiedByName = "descOrder")
    public abstract List<IssueNotificationResponse> notificationsToIssueResponsesDesc(List<Notification> notifications);
    
    @IterableMapping(qualifiedByName = "ascOrder")
    public abstract List<IssueNotificationResponse> notificationsToIssueResponsesAsc(List<Notification> notifications);

    @Named("descOrder")
    @AfterMapping
    public void afterMappingOrderDesc(@MappingTarget List<IssueNotificationResponse> target) {
        // 降序排序逻辑
    }

    @Named("ascOrder")
    @AfterMapping
    public void afterMappingOrderAsc(@MappingTarget List<IssueNotificationResponse> target) {
        // 升序排序逻辑
    }
}

方案2（兼容所有版本，匹配精度更高） #

如果使用低版本MapStruct方案1不生效，可以自定义@Qualifier注解来实现精准匹配：

1. 先定义两个限定符注解

import org.mapstruct.Qualifier;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Qualifier
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.CLASS)
public @interface AscSort {}

@Qualifier
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.CLASS)
public @interface DescSort {}

2. 修改Mapper的注解配置

@Mapper(componentModel = "spring")
public abstract class NotificationMapper {
    // ... 原有逻辑不变
    @IterableMapping(qualifiedBy = DescSort.class)
    public abstract List<IssueNotificationResponse> notificationsToIssueResponsesDesc(List<Notification> notifications);
    
    @IterableMapping(qualifiedBy = AscSort.class)
    public abstract List<IssueNotificationResponse> notificationsToIssueResponsesAsc(List<Notification> notifications);

    @DescSort
    @AfterMapping
    public void afterMappingOrderDesc(@MappingTarget List<IssueNotificationResponse> target) {
        // 降序排序逻辑
    }

    @AscSort
    @AfterMapping
    public void afterMappingOrderAsc(@MappingTarget List<IssueNotificationResponse> target) {
        // 升序排序逻辑
    }
}

注意事项 #

如果你的后置处理是针对集合中的单个元素而非整个集合，需要将@AfterMapping方法的@MappingTarget参数类型改为IssueNotificationResponse，并在单实体映射方法上配置@BeanMapping(qualifiedByName = "...")即可生效。

内容的提问来源于stack exchange，提问作者Mihai Catalin Valentin