MapStruct优雅实现：基于唯一ID从源DTO产品列表映射为目标DTO单个产品并解决嵌套Mapper注入问题

我完全懂你的困扰——手动用Mappers.getMapper()初始化嵌套Mapper确实不够优雅，尤其是当映射逻辑复杂、嵌套Mapper越来越多的时候，不仅代码冗余，还违背了Spring的依赖注入思想。其实只需要做几个小调整，就能让Spring自动帮你管理所有Mapper的依赖，同时保持代码的简洁性。

优化后的实现方案 #

核心思路是将主Mapper从接口改为抽象类，结合MapStruct的uses属性让Spring自动注入嵌套Mapper，彻底摆脱手动初始化的冗余代码：

1. 主抽象Mapper类（MainMapper）

@Mapper(componentModel = "spring", uses = {ProductMapper.class})
public abstract class MainMapper {

    // 由Spring自动注入ProductMapper，MapStruct会自动处理注入逻辑
    protected abstract ProductMapper productMapper;

    // 从配置文件读取目标产品ID，替代硬编码（更贴合实际业务场景）
    @Value("${business.desired.product.id}")
    private String desiredProductId;

    @Mapping(source = ".", target = "product", qualifiedByName = "mapProduct")
    public abstract Target map(SourceDto dto);

    @Named("mapProduct")
    protected Product mapProduct(SourceDto dto) {
        ProductDto desiredProduct = filterTargetProduct(dto);
        return productMapper.toProduct(desiredProduct);
    }

    private ProductDto filterTargetProduct(SourceDto dto) {
        return dto.getProducts().stream()
                .filter(product -> product.getId().equals(desiredProductId))
                .findAny()
                .orElseThrow(() -> new IllegalArgumentException(
                        String.format("目标产品未找到，ID：%s", desiredProductId)
                ));
    }
}

2. 嵌套产品Mapper接口（ProductMapper）

@Mapper(componentModel = "spring")
public interface ProductMapper {
    // 字段名一致时可省略@Mapping，MapStruct会自动映射同名属性
    Product toProduct(ProductDto dto);
}

关键调整点说明 #

• 改为抽象类：接口无法拥有可注入的成员变量（接口字段默认是public static final），而抽象类可以声明抽象的Mapper成员，MapStruct结合Spring会自动为生成的实现类注入依赖的ProductMapper。
• uses属性的作用：通过uses = {ProductMapper.class}告诉MapStruct当前Mapper依赖该嵌套Mapper，生成Spring Bean实现时会自动通过依赖注入获取实例，完全不需要手动初始化。
• 配置化获取目标ID：把硬编码的目标ID改为从配置文件读取（@Value注解），这也是抽象类的优势——可以方便地注入配置、其他Spring Bean等，比接口的默认方法灵活得多。
• 异常处理优化：将findAny().get()改为orElseThrow()，避免找不到产品时抛出模糊的NoSuchElementException，换成更具业务意义的异常，便于问题排查。

扩展场景适配 #

如果你的实际映射逻辑包含更多嵌套Mapper，只需要：

1. 在@Mapper的uses属性中添加对应的Mapper类
2. 在抽象主Mapper中声明对应的protected abstract [XxxMapper] xxxMapper字段
   MapStruct会自动处理所有嵌套Mapper的注入，彻底告别手动初始化的繁琐。

这种方式既符合Spring的依赖注入规范，又保持了映射逻辑的清晰性，对于复杂的映射场景非常友好，也避免了大量冗余代码。

内容来源于stack exchange