MyBatis Spring Boot Starter中ConfigurationFactory配置的深入解析

配置项未被使用的误解

在MyBatis Spring Boot Starter项目中，有用户报告称configurationFactory配置项未被使用。这实际上是一个误解，该配置项确实存在于MyBatis的核心功能中，只是它的使用场景较为特殊，不为大多数开发者所熟知。

ConfigurationFactory的真正用途

ConfigurationFactory是MyBatis中一个特殊的配置项，主要用于延迟加载属性。具体来说，它在反序列化传输的缓存对象后用于延迟加载属性。这个功能在分布式缓存或对象序列化/反序列化场景中尤为重要。

配置验证

MyBatis Spring Boot Starter项目中包含专门的测试用例来验证这个配置项的正确设置。测试代码明确检查了configurationFactory属性是否被正确配置和读取。

常见误解场景

许多开发者（包括报告此问题的用户）误以为可以通过configurationFactory来自定义Configuration类的实例化过程。实际上，这是对该配置项用途的误解。ConfigurationFactory并不是用来替换默认Configuration实现的机制。

自定义Configuration的正确方式

如果开发者确实需要自定义Configuration实现（例如继承org.apache.ibatis.session.Configuration创建自己的MyConfiguration类），正确的方式是通过显式创建SqlSessionFactoryBean并设置自定义的Configuration实例：

@Bean
@ConfigurationProperties(prefix = MybatisProperties.MYBATIS_PREFIX)
SqlSessionFactory sqlSessionFactoryBean(DataSource ds, MybatisProperties properties) throws Exception {
    final SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
    factoryBean.setDataSource(ds);
    // 其他factoryBean属性设置...
    MyConfiguration myConfig = new MyConfiguration();
    properties.getConfiguration().applyTo(myConfig);
    factoryBean.setConfiguration(myConfig);
    return factoryBean.getObject();
}

技术建议

1. 对于大多数常规需求，不建议继承Configuration类，这可能导致维护复杂性增加
2. 如果确实需要扩展功能，优先考虑通过Interceptor等MyBatis提供的扩展点实现
3. 自定义Configuration实现时，需要确保正确处理所有必要的初始化和配置

总结

ConfigurationFactory配置项在MyBatis中有其特定用途，虽然不常见但确实被框架使用。开发者不应将其误认为是自定义Configuration实现的机制。对于需要自定义Configuration的场景，应该采用显式创建和配置的方式，这虽然需要更多代码，但能确保功能的正确性和可维护性。