MyBatis-Plus 报错 Invalid bound statement(insert)？其实是 SqlSessionFactoryBean 踩坑了

在 Spring Boot 项目中接入MyBatis-Plus时，很多人都会遇到下面这个异常：

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): cn.xxx.xxxmapper.HaMapper.insert

表面看起来像是Mapper 或 XML 没配置好，但如果你已经：

• Mapper 能正常注入

• XML 的select能用

• 唯独BaseMapper.insert()报错

👉 那99% 是 SqlSessionFactoryBean 配置导致的。

本文通过一次真实踩坑经历，系统讲清楚：

• 问题产生的根因

• 为什么 MyBatis-Plus 特别容易中招

• 正确 & 官方推荐的解决方案

一、问题现象

异常信息如下：

Invalid bound statement (not found): cn.ha.xx.xxmapper.HaMapper.insert

对应代码：

haMapper.insert(entity);

而HaMapper定义如下：

public interface HaMapper extends BaseMapper<HaEntity> { }

看起来完全没问题，但一运行就报错。

二、为什么 MyBatis-Plus 会在 insert 上报错？

1️⃣ BaseMapper 的 SQL 是「自动注入」的

这是关键背景。

• insert / deleteById / updateById

• 并不在 XML 中

• 而是在SqlSessionFactory 初始化时

• 由 MyBatis-Plus 动态注册

这个注册过程只会发生在：MybatisSqlSessionFactoryBean中。

2️⃣ 手动配置 SqlSessionFactoryBean 会发生什么？

很多项目（尤其是老项目 / 多数据源）都会写类似配置：

@Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean(); factoryBean.setDataSource(dataSource); return factoryBean.getObject(); }

⚠️问题就在这里。

你虽然成功创建了 SqlSessionFactory，但：

• ❌ 绕开了 MyBatis-Plus 的自动配置

• ❌ BaseMapper 的 CRUD SQL 根本没有被注入

结果就是：

XML 里的 SQL 能用 BaseMapper.insert → Invalid bound statement

三、如何快速判断是不是这个坑？

你可以对照下面这个表：

如果你手动 new 了 SqlSessionFactoryBean，几乎可以直接确认原因。

四、正确的解决方案（官方推荐）

✅ 方案一：删除自定义 SqlSessionFactory（最推荐）

如果你不是多数据源、也没有特别定制需求：

@Configuration @MapperScan("cn.ha.xx.xxmapper") public class MybatisPlusConfig { }

只保留依赖：

<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> </dependency>

👉 MyBatis-Plus 会自动：

• 使用MybatisSqlSessionFactoryBean

• 注入 BaseMapper CRUD

• 扫描 Mapper

这是最稳妥、最不容易出问题的方式。

✅ 方案二：必须自定义时，用 MybatisSqlSessionFactoryBean

如果你确实需要手动配置（如插件、多数据源）：

@Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean factory = new MybatisSqlSessionFactoryBean(); factory.setDataSource(dataSource); factory.setMapperLocations( new PathMatchingResourcePatternResolver() .getResources("classpath:/mapper/**/*.xml") ); return factory.getObject(); }

❗重点只有一句：

不要再使用SqlSessionFactoryBean

✅ 方案三：多数据源场景（高频踩坑）

@Bean @Primary public SqlSessionFactory primarySqlSessionFactory(DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean factory = new MybatisSqlSessionFactoryBean(); factory.setDataSource(dataSource); return factory.getObject(); }

配合：

@MapperScan( basePackages = "cn.ha.xx.xxmapper", sqlSessionFactoryRef = "primarySqlSessionFactory" )

五、为什么这个坑特别隐蔽？

原因只有一个：

它不是配置错误，而是“配置覆盖成功了，但逻辑被绕开了”

• 不报 Bean 冲突

• 不报启动异常

• 直到你调用BaseMapper.insert才炸

非常具有迷惑性。

六、总结

如果你在 MyBatis-Plus 中遇到：

Invalid bound statement (not found): xxxMapper.insert

请第一时间检查：

❗ 是否手动配置了 SqlSessionFactoryBean

记住一句话就够了：

👉 用 MyBatis-Plus，就要让它掌控 SqlSessionFactory