Spring项目中Orika Mapper初始化后无法注册转换器求助

问题原因 #

Orika的MapperFacade一旦完成初始化，就会锁定MapperFactory的配置，禁止后续注册转换器、映射器或修改类映射规则。你的代码中，Spring的setApplicationContext方法是在Bean创建完成后才执行的，而ConfigurableMapper的默认构造逻辑会在Bean实例化阶段就自动初始化MapperFacade，导致此时注册转换器触发异常。

解决方案 #

1. 关闭ConfigurableMapper的自动初始化 #

ConfigurableMapper提供了带参数的构造函数，传入false可以关闭自动初始化，让我们手动控制初始化时机。

2. 调整代码逻辑，确保先注册所有组件再初始化Facade #

修改OrikaMapper类，在完成所有转换器、映射器的注册后，再手动调用init()方法初始化MapperFacade。

修改后的完整代码：

import ma.glasnost.orika.Converter;
import ma.glasnost.orika.Mapper;
import ma.glasnost.orika.MapperFactory;
import ma.glasnost.orika.impl.ConfigurableMapper;
import ma.glasnost.orika.impl.DefaultMapperFactory;
import org.springframework.beans.BeansException;
import org.springframework.context.ApplicationContext;
import org.springframework.context.ApplicationContextAware;
import org.springframework.stereotype.Component;
import java.util.Map;

@Component
public class OrikaMapper extends ConfigurableMapper implements ApplicationContextAware {
    private MapperFactory factory;

    // 构造函数传入false，关闭自动初始化
    public OrikaMapper() {
        super(false);
    }

    @Override
    protected void configureFactoryBuilder(final DefaultMapperFactory.Builder factoryBuilder) {
        // 可在这里配置工厂构建器的参数，比如设置类加载器等
    }

    @Override
    protected void configure(final MapperFactory factory) {
        this.factory = factory;
    }

    @Override
    public void setApplicationContext(final ApplicationContext applicationContext) throws BeansException {
        addAllSpringBeans(applicationContext);
        // 所有组件注册完成后，手动初始化MapperFacade
        init();
    }

    private void addAllSpringBeans(final ApplicationContext applicationContext) {
        final Map<String, Converter> converters = applicationContext.getBeansOfType(Converter.class);
        for (final Converter converter : converters.values()) {
            addConverter(converter);
        }

        final Map<String, Mapper> mappers = applicationContext.getBeansOfType(Mapper.class);
        for (final Mapper mapper : mappers.values()) {
            addMapper(mapper);
        }
    }

    public void addConverter(final Converter<?, ?> converter) {
        factory.getConverterFactory().registerConverter(converter);
    }

    public void addMapper(final Mapper<?, ?> mapper) {
        factory.classMap(mapper.getAType(), mapper.getBType())
                .byDefault()
                .customize(mapper)
                .register();
    }
}

关键修改点说明 #

• 构造函数：super(false)关闭ConfigurableMapper的自动初始化逻辑，避免提前创建MapperFacade
• setApplicationContext：在注册完所有Spring容器中的转换器和映射器后，调用init()方法完成MapperFacade的初始化，此时所有配置已准备完毕
• addMapper方法：移除了不必要的强制类型转换，简化代码

验证依赖配置 #

确保你的Orika依赖版本正确（1.5.4版本是稳定版，兼容Java 17和Spring 5.3.x）：

<dependency>
    <groupId>ma.glasnost.orika</groupId>
    <artifactId>orika-core</artifactId>
    <version>1.5.4</version>
</dependency>

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