解决Mabatis报错问题：org.apache.ibatis.binding.BindingException+xxx is not known to the MapperRegistry.问题总结

今天遇到mybatis的报错，搞了好久才搞懂，在网上找了好久的相似案例，最终才搞定自己的问题，于是总结 一下相关的问题，供有类似问题的小伙伴参考：

一、解决Mybatis报错问题：Type interface com.tjcu.dao.UserDao is not known to the MapperRegistry.

异常如下：

org.apache.ibatis.binding.BindingException: Type interface com.tjcu.dao.UserDao is not known to the MapperRegistry.

  at org.apache.ibatis.binding.MapperRegistry.getMapper(MapperRegistry.java:36)
  at org.apache.ibatis.session.Configuration.getMapper(Configuration.java:536)
  at org.apache.ibatis.session.defaults.DefaultSqlSession.getMapper(DefaultSqlSession.java:215)
  at com.tjcu.util.MybatisUtil.getMapper(MybatisUtil.java:57)
  at com.tjcu.test.UserTest.testSelectAll(UserTest.java:22)
  at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
  at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
  at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
  at java.lang.reflect.Method.invoke(Method.java:498)

• 解决方案分为两种情况：

1.在mybatis核心配置文件中（mybatis-config.xml）配置mappers

<!--  每个mappers.xml文件都需要在mybatis-config.xml核心配置文件中注册-->
 <mappers>
        <mapper resource="com/kuang/dao/UserMapper.xml"/>
 </mappers>

2.就是namespace编写出错（就是namespace的位置与实际文件位置不同）

注意报错中提示的：is not known to the MapperRegistry.这个表示没有这个映射地址，也就是说虽然配置文件中配置了，又能是SQL配置文件Mapper.xml中配置错误了，也有可能namespace中编写时出了错误，看下面一个实例：

• namespace的设置与文件实际的位置不同

将上面的namespace修改为正确位置后问题就解决了，如果不是这里出错那么就可能是xml中的mappers节点配置错误啦。

完成后这个问题就解决了，如果以上步骤完成后运行时还报错那么说明，那么xml配置文件错误了，查找方向为优先SQL映射文件（Mapper结尾的文件），然后再看mybatis-config.xml的错误，不过虽然MyBatis框架一般都是xml配置文件的编写错误，还是需要注意自己的Java代码是否有写正确！

二、解决org.apache.ibatis.binding.BindingException报错

通常情况下，遇到BindingException报错排查方法如下：

1、mapper接口和mapper.xml是否在同一个包（package)下？名字是否一样（仅后缀不同）？

2、mapper.xml的命名空间（namespace）是否跟mapper接口的包名一致？

3、接口的方法名，与xml中的一条sql标签的id一致

4、如果你的项目是maven项目，请你在编译后，到接口所在目录看一看，很有可能是没有生产对应的xml文件，因为maven默认是不编译的，因此，你需要在你的pom.xml的<build></build>里面，加这么一段：

<!--在build中配置resources，来防止我们资源导出失败的问题-->
<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

•  最终我的代码定位到的问题是：

项目启动报如下错误信息：

java.sql.SQLException: Unsupported character encoding 'utf-8;serverTimezone.......
分析：

• 由“java.sql.SQLException” 可知道很大概率是关于数据库的错误 
• 由“character encoding 'utf-8” 可分析应该是连接配置上出了问题

原配置文件里末尾还有个分号，被我去掉之后，并且改为了utf8，就运行正常了！（就这一点小问题有时候可能排查2小时 ，我哭死！）

<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false&amp;useUnicode=true&amp;characterEncoding=utf8"/>

刷新，重新启动，成功运行

另外 参考狂神mybatis视频中的p2的一些错误总结 参考：
1、xml不能有中文注释（我的IDEA2021+Maven3.8.1实测可以加中文注释，旧版本可能不行）
2、useSSL=false
3、MybatisUtils.java里面，原来是
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
改成——sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); 去了最前面的声明，因为前面 已经声明过了，private static SqlSessionFactory sqlSessionFactory;//提升作用域！！！
4、终于成功打印了，但是打印的是地址？？？因为要重写实体类的toString方法，就行了，打印输出的就是你怎么重写的内容！！

重写toString方法：