BindingException: Invalid bound statement (not found)问题排查:SpringBoot集成Mybatis重点分析

2023-04-20,,

重构代码,方法抛出异常:BindingException: Invalid bound statement (not found)

提示信息很明显:mybatis没有提供某方法

先不解释问题原因和排查过程,因为使用SpringBoot集成Mybatis,主要配置点如下:

MyBatis 的真正强大在于它的映射器Mapper,它是开发者用于绑定映射语句(sql)的接口,而映射语句常规两种写法:annotation 和 xml 配置;

如果单纯使用annotation的方式,最主要是关心mapper java文件;

但是我们推荐sql配置在xml中,强大的逻辑判断、字段映射、sql复用...

1、mapper xml文件的扫描

如果使用xml配置sql,需要告诉SpringBoot扫描这些xml,常用以下两种配置方法

方法一:配置文件指定扫描路径(推荐)

 mybatis:
mapper-locations: classpath:mapping/*.xml #注意:一定要对应mapper映射xml文件的所在路径
type-aliases-package: com.winter.model # 注意:对应实体类的路径

方法二:配置 SqlSessionFactory

Mybatis万能的SqlSessionFactory接口(还有一个SqlSession接口,他俩是mybatis的核心),直接在他里面指定xml路径

@Autowired
@Bean
public SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource,
PageHelper pageHelper) throws IOException {
SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();
sqlSessionFactoryBean.setDataSource(dataSource);
/** 添加mapper 扫描路径 */
PathMatchingResourcePatternResolver pathMatchingResourcePatternResolver = new PathMatchingResourcePatternResolver();
String packageSearchPath = ResourcePatternResolver.CLASSPATH_ALL_URL_PREFIX + "/sql/*.xml";
sqlSessionFactoryBean.setMapperLocations(pathMatchingResourcePatternResolver.getResources(packageSearchPath));
/** 设置datasource */
sqlSessionFactoryBean.setDataSource(dataSource); sqlSessionFactoryBean.setPlugins(new Interceptor[] { pageHelper });
return sqlSessionFactoryBean;
}

2、mapper接口的扫描

mapper接口是真正的java接口,使用动态代理,虽然只是接口定义,却实现了真正的sql执行、响应结果映射封装等,需要告诉SpringBoot扫描这些mapper接口,常用以下两种配置方法

方法一:接口上添加注解(推荐)

@Mapper
public interface PermissionMapper {
... 略 ...
}

方法二:指定扫描包路径

@MapperScan("com.XXX.XXX.services.mapper")

总之,SpringBoot中注意xml和mapper接口的扫描配置。

出现:BindingException: Invalid bound statement (not found) 这种异常,问题排查步骤:

1、先确认如上两个配置是否正常;

2、检查mapper文件,方法是否存在

3、检查xml文件,id=方法名 的sql是否存在,该xml对应的mapper接口是否存在

注意:

如果sql通过annotation注解写在mapper接口上,同时也使用了xml的方式,注意id不能重复,即使参数完全不同,id也必须不同(mybatis的xml里面可没有override的概念)

相同的id只能存在不同的namespace里面

BindingException: Invalid bound statement (not found)问题排查:SpringBoot集成Mybatis重点分析的相关教程结束。

《BindingException: Invalid bound statement (not found)问题排查:SpringBoot集成Mybatis重点分析.doc》

下载本文的Word格式文档,以方便收藏与打印。