SpringBoot集成Mapstruct时多Converter优先级配置失效如何解决

你之前使用@Order、@Primary不生效的核心原因是：mapstruct-spring-extensions默认的转换器注册逻辑，只会按Bean实例化顺序将所有扫描到的Converter直接注册到ConversionService，不会识别Spring的优先级注解，同类型的转换器后注册的会覆盖先注册的，因此注解配置不会生效。

方案1：排除自动生成的Mapper Bean（最推荐） #

既然你只需要使用自定义的扩展Mapper，直接从Spring容器扫描中排除自动生成的CarMapperImpl即可，容器中只会保留你写的CarMapperImplExtended，从根源上避免同类型转换器冲突：

@SpringBootApplication
@ComponentScan(excludeFilters = {
    @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = CarMapperImpl.class)
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

如果有多个自动生成的Mapper需要排除，可统一按类型加入excludeFilters列表即可。

方案2：自定义转换器注册逻辑，支持@Order优先级 #

如果你需要保留两个Converter实例，可自行实现转换器注册逻辑，按@Order值控制注册顺序，优先级更高的转换器后注册即可覆盖低优先级实现：

@Configuration
public class ConverterConfiguration implements ConverterRegistryConfigurer {
    @Autowired
    private ApplicationContext applicationContext;

    @Override
    public void configureConverterRegistry(ConverterRegistry registry) {
        // 按Spring原生的@Order规则排序，值越小优先级越高，优先级高的最后注册
        applicationContext.getBeansOfType(Converter.class).values().stream()
                .sorted(AnnotationAwareOrderComparator.INSTANCE)
                .forEach(registry::addConverter);
    }
}

配置完成后给你的扩展实现加@Order(Ordered.HIGHEST_PRECEDENCE)注解即可保证它优先生效：

@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
public class CarMapperImplExtended extends CarMapperImpl {
    // 原有逻辑不变
}

方案3：使用@Primary注解筛选优先转换器 #

如果更习惯用@Primary标记优先实现，可以在注册逻辑中优先筛选带@Primary注解的转换器注册：

@Configuration
public class ConverterConfiguration implements ConverterRegistryConfigurer {
    @Autowired
    private ApplicationContext applicationContext;

    @Override
    public void configureConverterRegistry(ConverterRegistry registry) {
        Map<ParameterizedType, List<Converter<?, ?>>> converterGroup = new HashMap<>();
        // 按Converter的泛型类型分组
        for (Converter<?, ?> converter : applicationContext.getBeansOfType(Converter.class).values()) {
            Type[] genericInterfaces = converter.getClass().getGenericInterfaces();
            for (Type type : genericInterfaces) {
                if (type instanceof ParameterizedType pt && pt.getRawType() == Converter.class) {
                    converterGroup.computeIfAbsent(pt, k -> new ArrayList<>()).add(converter);
                    break;
                }
            }
        }
        // 每组优先取带@Primary的转换器注册，没有则取第一个
        for (List<Converter<?, ?>> converters : converterGroup.values()) {
            Converter<?, ?> primaryConverter = converters.stream()
                    .filter(c -> applicationContext.findAnnotationOnBean(applicationContext.getBeanNamesForType(c.getClass())[0], Primary.class) != null)
                    .findFirst()
                    .orElse(converters.get(0));
            registry.addConverter(primaryConverter);
        }
    }
}

之后给你的扩展实现加@Primary注解即可优先生效。

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