Mybatis踩坑
1.包别名下存在同名类导致项目启动失败
- 描述:通过设置包别名
mybatis.typeAliasesPackage
来限定实体类的查询范围,当指定的包别名下存在相同的类名时会出现项目启动失败的问题 - 表现:项目启动时报错mybatis启动过程中sqlSessionFactory注入bean失败,此处提示注入失败的类不一定是导致问题的重复类,会随机显示为一个不相关的类注入失败
- 解决:
- 更改包别名,使其限制的范围更小,更精准,在指定的别名包中不存在同名类
- 删除或者更改存在的同名类
- 删除关于包别名的配置
mybatis.typeAliasesPackage
- 其他说明:在mybatis-plus中不会存在此问题,即时在包别名中存在相同的类启动也不会报错,据说是因为mybatis-plus会自动对重名类进行去重,而mybatis不会去重所以导致失败
- 问题高发场景:将两个项目进行整合合并,在两个项目中都存在一些相同的类,合并到一起未精准控制别名包的范围或者未及时清除同名类
2. mapper.xml中编写resultMap映射中对枚举属性处理不正确导致SQL执行失败
-
描述:当mapper.xml中存在未正确处理的枚举类型的属性映射(不仅仅指当前调用的mapper.xml,指所有的mapper.xml文件),会导致SQL执行后进行reslutSet处理时报错
-
表现:执行SQL后提示枚举类型不存在的错误,但是当前执行的SQL并没有使用到相关的枚举类型,比如提示某一个枚举类型XX中并没有当前执行的SQL中使用的枚举值,但是枚举XX并没有在当前的SQL中使用
-
解决:检查所有的mapper.xml文件中的关于枚举的类型有没有正确映射如下:
<result column="delete_flag" property="deleteFlag" javaType="com.example.enums.DeleteFlag" typeHandler="org.apache.ibatis.type.EnumTypeHandler"/>
-
其他说明:即使某些mapper.xml文件中存在未正确映射的枚举类型,只要调用的SQL不涉及枚举类型其SQL就可以正确执行,一旦某一条SQL执行涉及了枚举类型,那么所有mapper.xml中未正确映射的枚举类型都会导致SQL执行异常
-
问题高发场景:将mybatis-plus项目改造为mybatis时手动编写resultMap映射