mybatis配置entity下不同文件夹同类型名称的多个类型时启动springboot项目出现TypeException源码分析

记录问题:当配置了 mybatis.type-aliases-package=com.runjing.erp.entity 配置项时,如果entity文件夹下存在不同子文件夹下的同名类型时,mybatis初始化加载映射时会爆出org.apache.ibatis.type.TypeException: The alias 'TestDemo' is already mapped to the value'TestDemo全限定文件路径' 异常。

问题原因猜测:mybatis加载entity包下的实体类时,会扫描与其转换为非驼峰名称的数据库数据表,当同时出现多个同名称的类型时,别名加载异常,可能维护了一个存储别名的数据结构,如果别名恰巧就是以类型的简单名称为准,就容易导致其他同名的类型别名无法加载完成,爆出异常。

失败措施:起初以为时名称Test与mybatis内置的某个注解或者配置同名异常,全部将名称改为TestDemo后仍然报错。

分析mybatis相关源码:

异常语句打印源码地址:

以上代码可以看出在mybatis加载类型别名时,会自动调用别名注册方法,同时存储别名的数据结构是一个Map<String,Class<?>>的map,那么map内部插入一个key相同的键值对是一定不行的。

我们可发现这里校验了是否已经加载过这个类型,如果加载过,别名存储的数据结构中一定有对应的键值对,那么就会爆出这个异常。

那么mybatis是怎么加载实体类型与对应的别名注册的呢?

我们直接从spring boot对于mybatis的自动配置类上下手:

经过以上的条件验证后,利用SqlSessionFactoryBean创建一个SqlSessionFactory会话工厂。

初始加载时,会话工厂应当是空的,所有走向了这个Bean的所谓属性设置后的生命周期方法内部:

这里也是进行一些数据源,数据会话工厂构造器,数据源配置的相关验证,那么直接进入它构造会话工厂的方法内部:

方法过于的长,经过我的查看,里面包含有加载数据源、数据库、类型别名、映射Mapper文件、配置文件的代码。与我们这个问题相关的是以上圈起来的代码:

typeAliasesPackage 类型别名包,明显是mybatis配置过的加载实体类型的包路径数据。(注意我们自己在配置文件配置过此类信息

mybatis.type-aliases-package=com.runjing.erp.entity

拿到根路径后自然就是循环遍历里头的各级文件夹,扫描类型别名注册:

configuration.getTypeAliasRegistry().registerAliases(packageToScan,

typeAliasesSuperType == null ? Object.class : typeAliasesSuperType);

那么我们进入到这个方法的源码里查看下去:

注册类型别名的方法,继续跟踪:

扫描有没有使用mybatis的别名注解,如果没有继续调用注册方法,我没用,跟踪下去:

那么这里显然就是我们出现异常的原因点,问题结束。

相关推荐
Mahir082 小时前
Spring 循环依赖深度解密:从问题本质到三级缓存源码级解析
java·后端·spring·缓存·面试·循环依赖·三级缓存
YOU OU5 小时前
Spring IoC&DI
java·数据库·spring
小江的记录本7 小时前
【Java基础】Java 8-21新特性:JDK21 LTS:虚拟线程、模式匹配switch、结构化并发、序列集合(附《思维导图》+《面试高频考点清单》)
java·数据库·python·mysql·spring·面试·maven
云烟成雨TD9 小时前
Spring AI Alibaba 1.x 系列【58】Spring AI Alibaba Builtin Nodes 模块介绍
java·人工智能·spring
小江的记录本9 小时前
【Java基础】反射与注解:核心原理、自定义注解、注解解析方式(附《思维导图》+《面试高频考点清单》)
java·数据结构·python·mysql·spring·面试·maven
写了20年代码的老程序员9 小时前
写了 20 年 Java,我受够了 MyBatis 的 4 个瞬间
mybatis·orm
smileNicky9 小时前
Spring框架懒加载怎么实现?
python·spring·rpc
yychen_java10 小时前
IDEA × Qoder:告别“手写Spring”,进入AI协作开发新时代
人工智能·spring·intellij-idea
未若君雅裁11 小时前
Spring Bean 作用域、线程安全与生命周期
java·安全·spring
Ting-yu12 小时前
Spring AI Alibaba零基础速成(5) ---- Memory(记忆)
java·人工智能·后端·spring