MyBatis 主mapper.xml 配置文件中出现的路径配置错误

原创 已于 2023-09-23 23:31:03 修改 · 858 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#spring boot #mybatis #xml

于 2023-09-23 23:23:34 首次发布
文章讲述了在MyBatis主配置文件中遇到关于BlogMapper的错误，根源是XML解析时找不到Blog类型的类。解决方法是确保XML中的namespace和类路径配置完整。作者通过提供正确的配置示例解决了问题。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

【MyBatis中主配置文件中出现的错误】
Error while adding the mapper ‘interface com.example.demo.mapper.BlogMapper’ to configuration.

Error parsing Mapper XML. The XML location is ‘com/example/demo/mapper/BlogMapper.xml’. Cause: org.apache.ibatis.builder.BuilderException: Error resolving class. Cause: org.apache.ibatis.type.TypeException: Could not resolve type alias ‘Blog’. Cause: java.lang.ClassNotFoundException: Cannot find class: Blog

这个问题按照百度上面搜索的方法进行尝试后任然没有解决。但这个问题最本质的还是xml配置文件里类路径没有配置正确

问题配置如下：

此 type = “Blog” 在解析的过程中，无法识别User 类的位置，所以需要把完整的路径填写好，和 XML里的namespace配置类似

改进配置如下

运行后问题得到解决。

MyBatis中的Mapper文件配置——编写mybatis mapper.xml文件
AI天才研究院
07-29 6662
MyBatis 是一款优秀的持久层框架，它可以使得使用 SQL 和 HQL 来操作数据库变得很简单， MyBatis 将原生的jdbc API隐藏在接口中，使开发人员更关注业务逻辑，从而方便地实现数据持久化操作。MyBatis 中最重要的组件之一就是 MyBatis 的 Mapper XML 配置文件。Mapper XML 配置文件用来描述 MyBatis 映射器接口及其对应的 SQL、SQL语句的参数类型、返回值类型等信息。
【从零开发Mybatis】引入MapperConfig.xml和Mapper映射配置
疯一样的码农
10-14 1185
加载配置文件：从类路径中加载 MapperConfig.xml 文件。解析数据源信息：提取MapperConfig.xml 文件中的数据库连接信息（驱动、URL、用户名和密码）。读取 Mapper 文件：读取MapperConfig.xml 文件中指定的 Mapper 文件。解析 Mapper 文件中的 SQL 语句，并将 SQL 语句及其标识符存储在 Map 中。
ERROR [main] - Error while adding the mapper 'interface com.itheima.core.dao.CustomerDao' to configu
inexaustible的博客
11-26 7360
重启Apache服务器时报错： ERROR [main] - Error while adding the mapper 'interface com.itheima.core.dao.CustomerDao' to configuration. ERROR [main] - Error while adding the mapper 'interface com.itheima.core.d...
Error while adding the mapper ‘interface com.TestTunnel‘ to configuration.
wxtuan的博客
09-19 2350
出现如下报错： 2021-09-19 09:20:36.722 [main] ERROR org.mybat.sprin.mappe.MapperFactoryBean:[82]: Error while adding the mapper 'interface com.TestTunnel' to configuration. org.apache.ibatis.builder.BuilderException: Could not find value method on SQL annotati..
解决：Error while adding the mapper ‘interface *** to configuration. Error parsing Mapper XML.
qq_59055443的博客
04-27 1万+
在使用mybatis框架时出现了这个错误，我的错误原因是mapper配置文件的namespace命名错误 Wrong namespace. Expected 'com.dao.UserDao' but found 'UserDao'. 此处的namespace需要绑定到你的接口，就是你的接口的全路径。 例如我的就是com.dao.UserDao 在Mybatis中，映射文件中的namespace是用于绑定Dao接口的，即面向接口编程（我也不懂啥意思，资料里是这样说的）。当你的namespace绑
Error while adding the mapper ‘interface *****类‘ to configuration报错原因
weixin_45151960的博客
11-07 9624
启动项目报错： Error while adding the mapper ‘interface com.boc.ljh.mapper.UserMapper’ to configuration. ***UserMapper是我自己创建的mapper接口 原因：是因为报错的类对应的.xml文件错误，也就是UserMapper对应的UserMapper.xml文件错误导致的。 第一种情况：配置的.xml文件格式错误，导致以上报错。 第二种情况：namespace地址配置错误，导致以上报错。 第三种情况：只创建了
Error while adding the mapper？？？Error parsing Mapper XML？？？could not autowire field？？？...
02-15 1万+
不解释.先上控制台提示： 15:20:15,438ERRORmainmapper.MapperFactoryBean:97-Errorwhileaddingthemapper'interfacecom.sml.mapper.admin.DeskTopMapper'toconfiguration.java.lang.RuntimeException:Error...
详解mybatis-plus的 mapper.xml 路径配置的坑
09-07
本文将详细讲解mybatis-plus的mapper.xml路径配置的常见问题，并提供解决策略。 首先，我们需要理解Mybatis-Plus的工作原理。Mybatis-Plus是一个Mybatis的扩展库，它简化了基本的CRUD操作。它默认使用注解来定义SQL...
mybatis如何通过接口查找对应的mapper.xml及方法执行详解
08-30
- 这个过程通常在`SqlSessionFactory`构建时，解析配置文件中的`<mappers>`节点时触发。每个`<mapper>`子节点可以是一个资源路径，指向mapper.xml文件，或者是一个全限定的接口名。 3. **执行SQL**： - 当获取到...
Mybatis中的config.xml配置文件详细解析
08-28
Mybatis-config.xml配置文件详细解析 Mybatis-config.xml文件是Mybatis框架中最重要的配置文件之一，它负责配置Mybatis的整体环境和行为。这个文件的正确配置对Mybatis的使用起着至关重要的作用。下面我们将详细...
Error while adding the mapper ‘interface com.louis.mapper.StudentMapper‘ toxxx
weixin_63549044的博客
07-31 775
就是这么个小小细节，导致我找了一个多小时的解决办法，最终弄巧成拙，删掉了回车，才解决的bug！以此记录，也引以为戒！这次主打就是一个记录踩坑的小文章，先总结关于这类问题。
Error while adding the mapper ‘interface com.itheima.mapper.DeptMapper‘ to configuration.
2301_77994279的博客
08-08 665
在maper层写了一个@Select 注解,然后又在xml文件中写了一个sql语句,程序就抛出此异常,找了半天才找到,以为是没有加注解,看来看去都没有问题,最后找了半个小时才发现多写了一个sql.希望大家不要犯像我一样的错误。
Mybatis mapper配置无效
qq_44631777的博客
02-27 868
Mybatis mapper配置无效 在idea中 【记录我的第一篇博客】 在学习mybaits的过程中遇到了这样一个问题： 在resources文件下新建了mybatis.mapper目录，在该目录中写了xxxMapper.xml文件，在mybatis-config.xml中配置了mapper文件的路径。 注意:这里为了实验创建了两次目录，mybatis和mapper中间是“.”和“/”。 运行之后报错：说找不到mapper.xml文件。最后发现果然是路径问题。解决方法： ==在resources下创建
解决：Error while adding the mapper ‘interface to configuration. Error parsing Mapper XML
m0_67400972的博客
07-30 1962
当namespace绑定的是dao接口的全路径时，其实现数据持久化的方式为有代理模式实现数据持久化，即会自动产生代理，自动实现数据的持久化，不需要实现dao层的接口。当namespace绑定的是实体类的全路径时，其实现数据持久化的方式为无代理模式实现数据持久化，可以手动实现dao层的接口。当namespace绑定的是mapper接口对应的sql.xml文件时，其也是有代理模式自动实现数据持久化。此处的namespace需要绑定到你的接口，就是你的接口的全路径。namespace绑定dao层接口的全路径；..
解决Spring Boot报错Mapped Statements collection already contains value for...Error while adding the mapp
暗诺星刻的博客
03-08 5649
解决Spring Boot报错Mapped Statements collection already contains value for...Error while adding the mapper   今天，在笔者刚刚编写完一个上万行的 SpringBoot 项目后，第一次运行时，一运行果然马上就报错了。笔者从来没有哪一次是代码编写完就一次性通过的，显然这次也不例外。经过这次报错得到的教训是：一定要及时勤劳地编写单元测试。把单元测试拖到所有 Bug 全部查完之后再编写没有任何意义。 笔者报错时的运
mybatis-plus配置找不到Mapper接口路径的坑
热门推荐
又听凌晨的钟声
06-28 7万+
mybatis-plus今天遇到一个问题，就是mybatis 没有读取到mapper.xml 文件。 特此记录一下，问题如下： org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.husy.mapper.SystemUserMapper.findUserByName at co...
SpringBoot整合MyBatis --- mapper映射文件无法加载及路径问题
qq_44823091的博客
08-15 8555
mapper映射文件无法加载及路径问题 问题： 在SpringBoot整合MyBatis时，若mapper映射文件在java路径下，就会一直报错Invalid bound statement (not found): xxx.xxxMapper.selectxx 说明Mapper接口是可以调用到的，问题就出在无法映射到Mapper.xml文件。 同时查看输出target目录下，没有xxxmapp...
Error parsing Mapper XML. The XML location is
无梦相白的博客
05-08 1735
这样他们放在一起就会爆这个错误（我在整合SpringBoot+MybatisPlus时）报错是这个主要的意思差不多就是Mapper文件命名或者位置不规范，
Error parsing Mapper XML. The XML location is.......或者Could not resolve type alias
m0_52767002的博客
12-28 1731
Error parsing Mapper XML. The XML location is.......或者Could not resolve type alias
spring 如何配置讲mybatis得mapper.xml文件放在指定目录
最新发布
03-21
### Spring 中配置 MyBatis 的 Mapper.xml 文件到指定目录 在 Spring 和 MyBatis 结合使用的场景下，可以通过多种方式来配置 `Mapper.xml` 文件的位置。以下是几种常见的实现方法： #### 1. 使用 `<mappers>` 标签显式加载 XML 映射器 可以在 MyBatis 的核心配置文件（通常命名为 `mybatis-config.xml` 或其他自定义名称）中使用 `<mappers>` 标签手动指定映射器文件的路径。 ```xml <mappers> <!-- 方式一：通过具体路径 --> <mapper resource="com/sun/dao/UserMapper.xml"/> <!-- 方式二：通过类名 --> <mapper class="com.sun.dao.UserMapper"/> <!-- 方式三：通过包扫描 --> <package name="com.sun.dao"/> </mappers> ``` 上述代码片段展示了三种不同的加载方式[^1]。其中第三种方式最为常用，它允许自动扫描指定包下的所有接口及其对应的 `Mapper.xml` 文件。 --- #### 2. 将 Mapper.xml 放入 resources 资源目录 为了使 MyBatis 正确读取 `Mapper.xml` 文件，建议将其放置于项目的 `resources` 目录下。如果 `Mapper.xml` 文件位于 Java 源码目录而非标准资源目录，则需要调整其所在文件夹的属性为 “Resources Folder”，以便编译时能够被正确识别并打包[^2]。 例如： - 如果 `UserMapper.xml` 存在于 `src/main/resources/com/sun/dao/` 下，则可以直接通过如下方式进行引用： ```xml <mapper resource="com/sun/dao/UserMapper.xml"/> ``` --- #### 3. 基于 Spring Boot 自动化配置 当项目基于 Spring Boot 构建时，可以利用框架提供的自动化功能简化配置过程。只需确保以下条件满足即可完成默认配置： - 所有 `Mapper.xml` 文件均存放在 `resources/mapper` 或类似的约定位置； - 接口所在的包已注册至 MyBatis 的扫描范围。 示例代码如下所示： ```yaml # application.yml 配置 mybatis: mapper-locations: classpath:/mapper/*.xml type-aliases-package: com.example.domain ``` 此 YAML 配置指定了 `Mapper.xml` 文件的具体存储路径以及实体类别名的包路径[^4]。 --- #### 4. 动态生成 SqlSessionFactory 并设置 Mapper Locations 对于更复杂的场景，可能需要程序化地创建 `SqlSessionFactory` 实例并向其传递所需的参数。下面是一个典型的例子： ```java @Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { final SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean(); sessionFactory.setDataSource(dataSource); // 设置 Mapper.xml 文件的位置 PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); sessionFactory.setMapperLocations(resolver.getResources("classpath:/mapper/**/*.xml")); return sessionFactory.getObject(); } ``` 在此代码段中，调用了 `setMapperLocations()` 方法动态指定了多个匹配模式下的 `Mapper.xml` 文件地址[^3]。 --- ### 总结 无论采用何种策略，在实际开发过程中都应遵循良好的实践原则——即保持清晰一致的命名规则与合理的分层结构设计，从而提升系统的可维护性和扩展性。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值