映射属性时发现歧义映射方法——实体与DTO继承结构下的问题问询

这个问题我之前帮好几个开发者解决过，核心原因很明确：当你要把领域实体里的Set<Business>映射到IdentityDto的Set<BaseDto>时，MapStruct发现了多个符合条件的映射方法（比如你肯定定义了Business转BaseDto和Business转BusinessDto的方法），而BusinessDto又是BaseDto的子类，所以这两个方法都能满足“转成BaseDto类型”的要求，MapStruct就陷入了歧义，不知道该选哪个。

下面给你几个实用的解决方案，你可以根据自己的业务场景选择：

方案1：用@Named明确指定映射方法 #

给你想要用的单个实体映射方法打上@Named注解，然后在集合映射的地方指定使用这个命名的方法，让MapStruct精准匹配。

示例代码：

import org.mapstruct.Named;
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;

@Mapper
public interface YourMapper {

    // 给转BaseDto的方法命名
    @Named("toBaseDto")
    BaseDto toBaseDto(Business business);

    // 转BusinessDto的方法保留原样
    BusinessDto toBusinessDto(Business business);

    // 在Identity的映射里，指定businesses字段使用命名为toBaseDto的方法
    @Mapping(target = "businesses", qualifiedByName = "toBaseDto")
    IdentityDto toIdentityDto(Identity identity);

    // 如果需要批量映射列表，同样可以指定
    @Mapping(target = "businesses", qualifiedByName = "toBaseDto")
    List<IdentityDto> toIdentityDtoList(List<Identity> identities);
}

方案2：用@Primary标记优先使用的映射方法 #

如果在大部分场景下，你希望Business转BaseDto类型时默认用某个方法，可以给这个方法加上@Primary注解，MapStruct会优先选择它，避免歧义。

示例代码：

import org.mapstruct.Primary;
import org.mapstruct.Mapper;

@Mapper
public interface YourMapper {

    // 标记这个方法为优先使用的
    @Primary
    BaseDto toBaseDto(Business business);

    BusinessDto toBusinessDto(Business business);

    // 这里不需要额外配置，MapStruct会自动用@Primary的方法映射businesses
    IdentityDto toIdentityDto(Identity identity);
}

方案3：显式定义集合映射方法 #

自己手动写集合到集合的映射方法，在里面调用单个实体的映射逻辑，这样MapStruct就会直接使用你定义的这个明确方法，不会再去寻找候选方法。

示例代码：

import org.mapstruct.Mapper;
import java.util.Set;
import java.util.stream.Collectors;

@Mapper
public interface YourMapper {

    BaseDto toBaseDto(Business business);

    BusinessDto toBusinessDto(Business business);

    // 显式定义集合映射方法
    default Set<BaseDto> mapBusinessesToBaseDtoSet(Set<Business> businesses) {
        if (businesses == null) {
            return null;
        }
        return businesses.stream()
                .map(this::toBaseDto)
                .collect(Collectors.toSet());
    }

    // 直接使用上面的集合映射方法
    IdentityDto toIdentityDto(Identity identity);
}

选哪一种？如果只是个别字段需要特殊映射，方案1最灵活；如果有全局默认的映射优先级，方案2最省心；如果需要自定义集合映射的逻辑（比如空值处理、过滤等），方案3最合适。

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