MapStruct通用Mapper实现DTO默认值时的工厂方法歧义问题及通用解决方案咨询

看起来你已经搭建了一套很清晰的DTO层级和MapStruct映射体系，核心需求是自动给关联的MiniDTOResponse类型字段设置exists状态和默认值，但遇到了多Mapper继承GenericMapper时的工厂方法冲突问题——这个确实是MapStruct继承通用Mapper时的常见坑，我来给你几个适配你40+DTO场景的通用解决思路：

最优方案：将通用Mapper改为抽象类（彻底解决歧义） #

MapStruct中接口的默认方法在多继承场景下会被重复识别，导致“歧义工厂方法”的报错。把GenericMapper从接口改成抽象类，就能避免这个问题，同时完全复用所有通用逻辑：

1. 重构GenericMapper为抽象类 #

@Mapper(componentModel = "spring")
public abstract class GenericMapper {
    // 通用工具方法
    public boolean exists(String id) {
        return StringUtils.isNotBlank(id);
    }

    public boolean active(ZonedDateTime dateDeletion) {
        return dateDeletion == null;
    }

    public boolean computeExists(BaseEntity entity) {
        return entity != null && exists(entity.getId()) && active(entity.getFechaBaja());
    }

    // 通用的exists字段设置逻辑
    @AfterMapping
    protected <K extends BaseEntity, T extends MiniDTOResponse> void setExists(@MappingTarget T dto, K entity) {
        boolean exists = computeExists(entity);
        dto.setExists(exists); // 修正你原代码里的笔误（hay → exists）
    }

    // 全局通用的DTO工厂方法
    @ObjectFactory
    public <K extends BaseEntity, T extends MiniDTOResponse> T createDto(K source, @TargetType Class<T> dtoClass) {
        try {
            T dto = dtoClass.getDeclaredConstructor().newInstance();
            setExists(dto, source);
            return dto;
        } catch (Exception e) {
            throw new RuntimeException("Couldn't create DTO", e);
        }
    }

    // 生成"不存在"状态的默认DTO方法
    public <T extends MiniDTOResponse> T createDTOwithExitsFalse(Class<T> dtoClass) {
        try {
            T dto = dtoClass.getDeclaredConstructor().newInstance();
            dto.setExists(false);
            return dto;
        } catch (Exception e) {
            throw new RuntimeException("Couldn't create DTO", e);
        }
    }
}

2. 子Mapper继承抽象类 #

所有业务Mapper直接继承这个抽象类即可，无需额外配置，MapStruct会自动使用父类的工厂方法，不会再出现歧义：

@Mapper(componentModel = "spring", uses = {ToiletMapper.class})
public abstract class AttendanceMapper extends GenericMapper {
    @Mapping(target = "numStanding", source = "standing")
    @Mapping(target = "numSeats", source = "seats")
    @Mapping(target = "services", source = "installations", defaultExpression = "java(createDTOwithExitsFalse(ServicesDTOResponse.class))")
    @Mapping(target = "vip", source= "vipFacilities", defaultExpression = "java(createDTOwithExitsFalse(VIPDTOResponse.class))")
    public abstract AttendanceDTOResponse toDto (Attendance source);
}

备选方案：用@Named注解指定唯一工厂方法 #

如果不想改成抽象类，可以给通用工厂方法加@Named标识，然后在子Mapper中明确指定使用该方法：

1. 给通用工厂方法加@Named #

@Mapper(componentModel = "spring")
public interface GenericMapper {
    // ... 其他通用方法不变 ...

    @ObjectFactory
    @Named("genericFactory")
    default <K extends BaseEntity, T extends MiniDTOResponse> T createDto(K source, @TargetType Class<T> dtoClass) {
        // 实现逻辑不变
    }
}

2. 子Mapper指定使用该命名方法 #

@Mapper(
    componentModel = "spring",
    uses = {ToiletMapper.class},
    objectFactory = @ObjectFactory(qualifiedByName = "genericFactory")
)
public interface AttendanceMapper extends GenericMapper {
    // 映射方法不变
}

⚠️ 注意：这个方案需要给每一个业务Mapper都配置objectFactory属性，对于40多个DTO来说比较繁琐，所以更推荐第一种抽象类的方案。

额外优化建议 #

1. 避免重复构造调用：可以给MiniDTOResponse的子类都添加无参构造器（你已经用了@Data，Lombok会自动生成，没问题），确保createDto方法能正常实例化。
2. 全局默认值统一：如果希望MiniDTOResponse的非exists字段（比如light、numVIPSeats）在exists:false时自动设为默认值（0/false/null），可以在createDTOwithExitsFalse中统一处理，或者在DTO类的字段上直接设置默认值（比如private boolean light = false;）。
3. 笔误修正：你原代码中dto.setExists(hay);是明显的笔误，要改成dto.setExists(exists);，否则会编译报错。

这样调整后，你的映射逻辑会完全符合预期：当关联实体存在时自动设置exists:true并映射字段，不存在时返回exists:false的默认结构，完美生成你想要的JSON响应。

内容来源于stack exchange