巨坑,org.apache.ibatis.binding.BindingException:Invalid bound statement (not found)绑定异常出现原因和解决方法

BindingException

绑定异常,(其实出现这个问题实质就是mapper接口和mapper.xml文件没有映射起来。)

异常提示信息如下:
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found) :cn.tedu.csmall.server.mapper.BrandMapper.insert

出现这个问题,排查思路:

  • 在XML中配置的接口名有误 (mapper.xml中的namespace和实际的mapper文件不一致)

  • 节点的namespace属性值有误
    在XML中配置的抽象方法名称有误(mapper接口中的方法名和mapper.xml中的id标签不一致)

  • 或类似节点的id属性值有误
    在配置文件中指定的XML路径,此项配置有误

  • application.properties中配置的mybatis.mapper-locations属性有误

  • 上面问题都没有,但是还是不行,可能原因就是,没有构建进去,打开target看看对应的mapper.xml文件在不在

如果不在,恭喜你,即将学到新知识

SpringBoot项目整合Mybatis时Mapper.xml文件的存放位置
方式一: 放在与Mapper接口同级目录

在pom.xml中 节点添加如下配置,用于加载资源:

<build>
    <resources>
        <!-- 扫描src/main/java下所有xx.xml文件 -->
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
        </resource>
        <!-- 扫描resources下所有资源 -->
        <resource>
            <directory>src/main/resources</directory>
        </resource>
    </resources>
</build> 

方式二:在resources创建Mapper接口同名文件夹用来存放Mapper.xml文件(很繁琐,不推荐)

方式三:在resources目录下创建mapper文件夹存放mapper.xml(推荐)
在 application.properties 中做如下配置:
mybatis.mapper-locations=classpath:/mapper/*.xml