springboot使用使用mybatis报错BindingException

最新推荐文章于 2025-07-14 22:44:22 发布

原创最新推荐文章于 2025-07-14 22:44:22 发布 · 1k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis #springboot

java 同时被 3 个专栏收录

37 篇文章

订阅专栏

springboot

19 篇文章

订阅专栏

mybatis

3 篇文章

订阅专栏

本文详细解析了在SpringBoot项目中整合MyBatis时常见的BindingException错误，包括检查名称、命名空间、SQL语句ID、返回值类型及打包配置等问题，并提供了具体的解决步骤。

springboot使用使用mybatis报错BindingException

使用springboot在启动类添加上@MapperScan(“com.jd.mapper”)注解，扫描mapper所在的包，否则springboot无法启动。

使用mybatis的使用报错为：
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.jd.mapper.UserMapper.getUserList
主要是为绑定Mapper接口和Mapper.xml 异常。

解决方式

1、检查名称

两个文件的名称要完全一致，仅后缀不同。
在这里插入图片描述

2、检查命名空间

在mapper.xml中命名空间是接口的全限定路径。
在这里插入图片描述

3、检查sql语句的id

sql语句中的id要与接口中的方法名一致。

接口中的方法
在这里插入图片描述
mapper.xml 中的sql的id

4、检查返回值

sql中的resultType是否与接口的返回值一致。

注意：尽量使用resultMap，进行逐一对应。并且如果使用到别名的话，在配置文件中配置

mybatis.type-aliases-package=com.jd.domain

5、查看mapper.xml是否打包到target

使用maven管理项目的话，maven不会打包main/java下的 .xml文件，只会打包 .java。如下图没有打包，需要添加pom文件打包。
在这里插入图片描述
将mapper.xml编译打包有两种方式：
1、添加编译命令，将java包下的xml一同打包。

    <build>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
              	    <!--任意包下的任意名称的xml文件-->
                    <include>**/*.xml</include>
                </includes>
            </resource>
        </resources>
    </build>

2、mapper.xml和接口分离
将mapper.xml 与接口分离，将mapper.xml放在main/resources之下，
并且在配置文件中添加mapper文件的位置信息：

mybatis.mapper-locations=classpath:mapper/*.xml

在这里插入图片描述

总结

建议使用mybatis的插件，更好的将mapper接口和mapper.xml结合起来。
使用这个插件很好用。
在这里插入图片描述
使用之后会出现蓝色箭头，直接对应找到mapper.xml

另外：纪录一下mapper.xml文件的头文件约束。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.jd.mapper.UserMapper">

</mapper>