Mybatis的Mapper中的方法为什么不能重载？

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name ‘sqlSessionFactory’ defined in class path resource [org/mybatis/spring/boot/autoconfigure/MybatisAutoConfiguration.class]: Bean instantiation via factory method failed; nested exception is org.springframework.beans.BeanInstantiationException: Failed to instantiate [org.apache.ibatis.session.SqlSessionFactory]: Factory method ‘sqlSessionFactory’ threw exception; nested exception is org.springframework.core.NestedIOException: Failed to parse mapping resource: ‘file [H:\work_project\demo\target\classes\mapper\UserInfoMapper.xml]’; nested exception is org.apache.ibatis.builder.BuilderException: Error parsing Mapper XML. The XML location is ‘file [H:\work_project\demo\target\classes\mapper\UserInfoMapper.xml]’. Cause: java.lang.IllegalArgumentException: Mapped Statements collection already contains value for cn.cb.demo.dao.UserMapper.selectList. please check file [H:\work_project\demo\target\classes\mapper\UserInfoMapper.xml] and file [H:\work_project\demo\target\classes\mapper\UserInfoMapper.xml]

at org.springframework.beans.factory.support.ConstructorResolver.instantiate(ConstructorResolver.java:655)

at org.springframework.beans.factory.support.ConstructorResolver.instantiateUsingFactoryMethod(ConstructorResolver.java:635)

at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.instantiateUsingFactoryMethod(AbstractAutowireCapableBeanFactory.java:1336)

at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1176)

at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:556)

at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:516)

at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:324)

at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:226)

at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:322)

at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:202)

at org.springframework.beans.factory.config.DependencyDescriptor.resolveCandidate(DependencyDescriptor.java:276)

at org.springframework.beans.factory.support.DefaultListableBeanFactory.doResolveDependency(DefaultListableBeanFactory.java:1307)

at org.springframework.beans.factory.support.DefaultListableBeanFactory.resolveDependency(DefaultListableBeanFactory.java:1227)

at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.autowireByType(AbstractAutowireCapableBeanFactory.java:1509)

… 81 more

• 这么一大串什么意思？懵逼了~

• 大致的意思：cn.cb.demo.dao.UserMapper.selectList这个id已经存在了，导致创建sqlSessionFactory失败。

为什么不能重载？

---

• 通过上面的异常提示可以知道创建sqlSessionFactory失败了，这个想必已经不陌生吧，顾名思义，就是创建SqlSession的工厂。

• Springboot与Mybatis会有一个启动器的自动配置类MybatisAutoConfiguration，其中有一段代码就是创建sqlSessionFactory，如下图：

• 既然是创建失败，那么肯定是这里出现异常了，这里的**「大致思路」**就是：

❝

解析XML文件和Mapper接口，将Mapper中的方法与XML文件中<select>、<insert>等标签一一对应，那么Mapper中的方法如何与XML中<select>这些标签对应了，当然是唯一的id对应了，具体如何这个id的值是什么，如何对应？下面一一讲解。

❞

• 如上图的SqlSessionFactory的创建过程中，前面的部分代码都是设置一些配置，并没有涉及到解析XML的内容，因此答案肯定是在最后一行return factory.getObject();，于是此处打上断点，一点点看。于是一直到了org.mybatis.spring.SqlSessionFactoryBean#buildSqlSessionFactory这个方法中，其中一段代码如下：

• 这里的xmlMapperBuilder.parse();就是解析XML文件与Mapper接口，继续向下看。

• 略过不重要的代码，在org.apache.ibatis.builder.xml.XMLMapperBuilder#configurationElement这个方法中有一行重要的代码，如下图：

• 此处就是根据XML文件中的select|insert|update|delete这些标签开始构建MappedStatement了。继续跟进去看。

• 略过不重要的代码，此时看到org.apache.ibatis.builder.MapperBuilderAssistant#addMappedStatement这个方法返回值就是MappedStatement，不用多说，肯定是这个方法了，仔细一看，很清楚的看到了构建id的代码，如下图：

• 从上图可以知道，创建id的代码就是id = applyCurrentNamespace(id, false);，具体实现如下图：

❝

上图的代码已经很清楚了，MappedStatement中的id=Mapper的全类名+'.'+方法名。如果重载话，肯定会存在id相同的MappedStatement。

❞

• 到了这其实并不能说明方法不能重载啊，重复就重复呗，并没有冲突啊。这里需要看一个结构，如下：

protected final Map<String, MappedStatement> mappedStatements = new StrictMap(“Mapped Statements collection”)

.conflictMessageProducer((savedValue, targetValue) ->

". please check " + savedValue.getResource() + " and " + targetValue.getResource());

• 构建好的MappedStatement都会存入mappedStatements中，如下代码：

public void addMappedStatement(MappedStatement ms) {

//key 是id

mappedStatements.put(ms.getId(), ms);

}

• StrictMap的put(k,v)方法如下图：

❝

到了这里应该理解了吧，这下抛出的异常和上面的异常信息对应起来了吧。这个StrictMap不允许有重复的key，而存入的key就是id。因此Mapper中的方法不能重载。

❞

如何找到XML中对应的SQL？

---

• 在使用Mybatis的时候只是简单的调用Mapper中的方法就可以执行SQL，如下代码：

List userInfos = userMapper.selectList(Arrays.asList(“192”,“198”));

❝

一行简单的调用到底如何找到对应的SQL呢？其实就是根据id从Map<String, MappedStatement> mappedStatements中查找对应的MappedStatement。

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Java开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！
5%以上Java开发知识点，不论你是刚入门Java开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！**

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！