今天遇到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&useUnicode=true&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方法: