Orika Mapper问题：MapperFacade初始化后无法注册转换器

这个错误是Orika的核心机制导致的：一旦你从MapperFactory获取了MapperFacade实例，这个工厂就会被锁定，无法再注册新的转换器、映射关系或者修改任何配置。你的代码里用了静态的MapperFactory，并且每次调用转换方法时才去获取BoundMapperFacade，这就会导致第一次调用后工厂被锁定，后续如果有新的映射尝试初始化（比如你的toUserEntity方法），就会触发这个报错。

解决方案：提前初始化所有映射配置，使用全局单例的MapperFacade #

Orika的MapperFacade是线程安全的，完全可以全局复用。我们只需要在类加载阶段一次性完成所有映射配置和转换器注册，然后创建一个全局的MapperFacade实例即可。修改后的代码如下：

public class ObjectMapper {
    // 全局复用的MapperFacade实例
    private static final MapperFacade mapperFacade;

    static {
        // 初始化MapperFactory
        MapperFactory mapperFactory = new DefaultMapperFactory.Builder().build();
        
        // 提前注册所有需要的类映射关系
        // 配置ClientDTO到ClientEntity的映射（默认匹配同名属性）
        mapperFactory.classMap(ClientDTO.class, ClientEntity.class)
                     .byDefault()
                     .register();
        // 配置UserDTO到UserEntity的映射
        mapperFactory.classMap(UserDTO.class, UserEntity.class)
                     .byDefault()
                     .register();
        
        // 如果有自定义转换器，在这里注册（必须在创建MapperFacade之前）
        // mapperFactory.getConverterFactory().registerConverter(new YourCustomConverter());
        
        // 初始化全局MapperFacade，这一步会锁定MapperFactory
        mapperFacade = mapperFactory.getMapperFacade();
    }

    public static ClientEntity toClientEntity(ClientDTO clientDTO) {
        return mapperFacade.map(clientDTO, ClientEntity.class);
    }

    public static UserEntity toUserEntity(UserDTO userDTO) {
        return mapperFacade.map(userDTO, UserEntity.class);
    }
}

为什么这样能解决问题？ #

1. 静态代码块只执行一次：在类第一次被加载时，我们完成所有映射配置和转换器注册，然后创建MapperFacade，此时MapperFactory被锁定，后续不会再修改它。
2. 全局复用MapperFacade：避免了每次调用转换方法时都去创建新的BoundMapperFacade，既提升了性能，也不会触发工厂锁定后的配置修改操作。
3. 线程安全：Orika的MapperFacade设计为线程安全，多线程环境下可以放心使用。

额外注意事项 #

• 如果后续需要新增映射关系，一定要在静态代码块里添加，不要在业务方法中动态修改MapperFactory。
• 自定义转换器必须在创建MapperFacade之前注册到ConverterFactory中，否则同样会触发类似的报错。

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