项目整合之Mybatis踩坑

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映射