MyBatis-Plus多数据源场景下saveBatch方法获取SqlSessionFactory异常分析

问题背景

在MyBatis-Plus 3.5.6版本中，当项目配置了多个SqlSessionFactory（多数据源场景）时，使用ServiceImpl的saveBatch方法进行批量插入操作会出现异常。异常信息显示"Mapped Statements collection does not contain value"，表明系统无法找到对应的Mapper映射语句。

问题本质

这个问题的核心在于3.5.6版本中SqlSessionFactory的获取方式发生了变化：

1. 3.5.5版本：从sqlSessionTemplate获取sqlSessionFactory
2. 3.5.6版本：改为从GlobalConfigUtils获取sqlSessionFactory

在多数据源环境下，GlobalConfigUtils获取的可能是默认的SqlSessionFactory，而非当前Mapper对应的SqlSessionFactory，导致无法找到正确的Mapper映射。

技术细节分析

在MyBatis-Plus的多数据源场景中，每个Mapper通常会绑定到特定的SqlSessionFactory。3.5.6版本的改动破坏了这种绑定关系：

1. 批量操作机制：saveBatch方法内部会使用SqlHelper执行批量操作
2. SqlSession获取：批量操作需要获取正确的SqlSession来执行SQL
3. 版本差异：
   • 3.5.5通过sqlSessionTemplate获取，保持了与当前Mapper的关联
   • 3.5.6直接获取全局配置的SqlSessionFactory，失去了这种关联

解决方案

对于遇到此问题的开发者，有以下几种解决方案：

1. 升级到3.5.7版本：MyBatis-Plus团队已在3.5.7版本中修复了此问题
2. 临时解决方案（适用于必须使用3.5.6的情况）：
   • 继承ServiceImpl并重写getSqlSessionFactory方法
   • 将获取方式改回3.5.5的实现

   @Override
   public SqlSessionFactory getSqlSessionFactory() {
       return super.getSqlSessionTemplate().getSqlSessionFactory();
   }
   

最佳实践建议

在多数据源项目中使用MyBatis-Plus时，建议：

1. 版本选择：尽量使用最新稳定版本，避免已知问题
2. 批量操作测试：在多数据源场景下，务必测试批量操作方法
3. 自定义实现：对于特殊需求，可以通过继承核心类并重写关键方法来实现定制

总结

MyBatis-Plus作为增强版的MyBatis框架，在简化开发的同时，也需要开发者关注其内部机制。特别是在多数据源等复杂场景下，理解框架的核心组件（如SqlSessionFactory）的获取和使用方式尤为重要。这次3.5.6版本的问题提醒我们，即使是小版本升级，也可能带来不兼容的改动，因此在升级后需要进行充分的测试验证。