如何在MapStruct Spring Extension中为接口注册外部转换？

在Spring Boot+MapStruct的场景下，确实可以通过共享接口实现批量注册，不用再逐个添加@ExternalConversion，下面是两种可行的方案：

方案一：结合Spring Bean扫描实现批量转换器工厂 #

MapStruct本身没提供按接口批量注册的直接功能，但可以借助Spring的上下文扫描能力，自定义一个ConverterFactory来自动识别所有实现共享接口的领域模型：

1. 编写自定义ConverterFactory #

这个工厂会从Spring上下文里捞取所有实现目标共享接口的Bean，并自动匹配对应的MapStruct转换器：

@Component
public class SharedDomainConverterFactory<S extends SharedDomainInterface, T> implements ConverterFactory<S, T> {

    private final ApplicationContext ctx;
    private final Map<Class<?>, Converter<?, ?>> converterCache = new ConcurrentHashMap<>();

    public SharedDomainConverterFactory(ApplicationContext ctx) {
        this.ctx = ctx;
    }

    @Override
    public <U extends T> Converter<S, U> getConverter(Class<U> targetType) {
        return (Converter<S, U>) converterCache.computeIfAbsent(targetType, type -> {
            // 获取所有实现SharedDomainInterface的领域类Bean
            Map<String, ? extends SharedDomainInterface> domainBeans = ctx.getBeansOfType(SharedDomainInterface.class);
            for (SharedDomainInterface domainBean : domainBeans.values()) {
                Class<?> domainType = domainBean.getClass();
                // 查找对应类型的MapStruct转换器
                try {
                    return ctx.getBean(Converter.class, domainType, type);
                } catch (NoSuchBeanDefinitionException e) {
                    // 跳过找不到转换器的领域类
                    continue;
                }
            }
            throw new IllegalArgumentException("找不到目标类型[" + targetType.getName() + "]对应的转换器");
        });
    }
}

2. 注册到ConversionService #

在Spring配置类里把这个自定义工厂加到ConversionService中，替换原来逐个注册的逻辑：

@Configuration
public class ConversionConfig {

    @Bean
    public ConversionService conversionService(SharedDomainConverterFactory converterFactory) {
        DefaultConversionService conversionService = new DefaultConversionService();
        // 批量注册共享接口对应的转换器工厂
        conversionService.addConverterFactory(converterFactory);
        // 保留其他需要单独注册的转换器（如果有的话）
        return conversionService;
    }
}

方案二：定义通用MapStruct Mapper接口 #

如果你的领域模型和DTO都有对应的共享接口，可以先定义一个通用的Mapper父接口，让所有具体映射器继承它，Spring会自动扫描并注册所有子Mapper：

1. 编写通用父Mapper #

@Mapper(componentModel = "spring")
public interface BaseSharedMapper<S extends SharedDomainInterface, D extends SharedDtoInterface> 
    extends Converter<S, D> {

    @Override
    D convert(S source);

    // 在这里定义所有共享接口通用的映射规则，比如字段映射、类型转换
}

2. 具体领域模型的Mapper继承父接口 #

@Mapper(componentModel = "spring")
public interface DomainModel1Mapper extends BaseSharedMapper<DomainModel1, DomainModel1Dto> {
    // 不需要重复写convert方法，自动继承父接口的映射规则
    // 可以在这里添加DomainModel1特有的映射逻辑
}

这样Spring会自动扫描所有继承BaseSharedMapper的Mapper实现类，无需手动逐个注册到ConversionService。

注意点 #

• 确保所有实现共享接口的领域类都有对应的Mapper接口，且Spring能扫描到这些Mapper（比如放在@ComponentScan的路径下）
• 自定义ConverterFactory时加了缓存，避免每次转换都去上下文查找，提升性能
• 如果不同领域类的映射规则差异较大，方案二更灵活；如果只是批量注册，方案一更直接

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