[Java][MyBatis]mapperLocations属性通配符的使用

最新推荐文章于 2025-05-14 20:15:14 发布
转载 最新推荐文章于 2025-05-14 20:15:14 发布 · 10w+ 阅读 · 34

本文详细介绍了MyBatis中mapperLocations属性的通配符使用方法，包括如何正确配置以加载多级目录下的Mapper文件，并附带了常见错误示例。

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

mapperLocations属性通配符的使用

示例：

	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
		<property name="dataSource" ref="dataSource" />
		<property name="configLocation" value="classpath:sqlMapConfig.xml"></property>
		<property name="mapperLocations" value="classpath*:com/huaxin/**/*Mapper.xml"></property>
	</bean>

注意点：在classpath后面的*必不可少，缺少型号的话后面的通配符不起作用。

                **表示可以表示任意多级目录，如：上述配置可以查到【com/huaxin/framework/system/dao/UserDaoMapper.xml】

                *表示多个任意字符


               缺少classpath后面的*会报以下的错误：

org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.exceptions.PersistenceException: 
### Error querying database.  Cause: java.lang.IllegalArgumentException: Mapped Statements collection does not contain value for framework.system.dao.UserDao.getNextUserId_MySQL
### Cause: java.lang.IllegalArgumentException: Mapped Statements collection does not contain value for framework.system.dao.UserDao.getNextUserId_MySQL
	at org.mybatis.spring.MyBatisExceptionTranslator.translateExceptionIfPossible(MyBatisExceptionTranslator.java:75)
	at org.mybatis.spring.SqlSessionTemplate$SqlSessionInterceptor.invoke(SqlSessionTemplate.java:371)
	at com.sun.proxy.$Proxy18.selectOne(Unknown Source)
	at org.mybatis.spring.SqlSessionTemplate.selectOne(SqlSessionTemplate.java:163)
	at com.huaxin.framework.core.dao.impl.BaseDaoImpl.selectOne(BaseDaoImpl.java:298)
	at com.huaxin.framework.system.dao.impl.UserDaoImpl.getNextUserId(UserDaoImpl.java:41)


Java开发 - Mybatis框架初体验
CodingFire的博客
01-15 2344
在前文中，我们已经学习了Spring框架，Spring MVC框架，相信大家对这些基础的内容已经熟练使用了，今天，我们继续来学习Mybatis框架。就目前而言，Mybatis框架依然是比较实用的框架，这篇博客，将通过Mybatis框架和Spring框架的结合，来讲解Mybatis框架的使用，学完之后你就可以自己写接口玩了。Mybatis的主要作用是快速实现对关系型数据库中的数据进行访问的框架。Mybatis可以不依赖于Spring框架直接使用，但是，需要进行大量的配置，导致前期工作量比较大。
Spring整合MyBatis原理之MapperScannerConfigurer（一）
桐花思雨
04-19 2772
目录前言`spring` 整合 `mybatis` 原理1. 类 `MapperScannerConfigurer`类 `MapperScannerConfigurer` 小结2. 类 `SqlSessionFactoryBean`类 `SqlSessionFactoryBean` 小结3. 解析 `DAO` 文件解析 `DAO` 文件小结4. `DAO` 接口被调用`spring` 整合 `mybatis` 原理流程步骤 前言 spring 和 mybatis 进行整合时，需要使用以下这个依赖包 <
[MyBatis]mapperLocations属性通配符的使用
WGH100817的博客
01-16 562
mapperLocations属性通配符的使用 示例： [html] view plain copy print?<beanid="sqlSessionFactory"class="org.mybatis.spring.SqlSessionFactoryBean"><propertyname="dat...
spring中的@MapperScan注解详解
最新发布
技术人集结地
05-14 1847
@MapperScan是Spring与MyBatis集成时用于批量扫描Mapper接口的核心注解，主要功能包括自动注册Mapper接口、简化配置和支持多数据源。通过指定包路径，Spring会自动扫描并注册Mapper接口为Spring Bean，无需手动添加@Mapper注解。注解属性如basePackages、sqlSessionFactoryRef等提供了灵活的扫描控制和多数据源支持。底层实现通过动态代理和MapperScannerRegistrar完成Bean注册。最佳实践包括在Spring Boot
mapperLocations属性通配符classpath*
weixin_49574902的博客
05-14 4362
在classpath后面的*必不可少，缺少型号的话后面的通配符不起作用。 **表示可以表示任意多级目录，如：上述配置可以查到【com/huaxin/framework/system/dao/UserDaoMapper.xml】 *表示多个任意字符 注意：value=“classpath*:com/huaxin/**/*Mapper.xml” ，.xml前面必须有字母. 如果写成 value=“classpath*:com/huaxin/**/*.xml”
mapperLocations属性通配符的使用
随便起个不重复的名字
09-21 2152
参见：http://blog.csdn.net/szwangdf/article/details/23432783
Mybatis 实体别名支持通配符扫描
暴走编程的博客
01-17 916
问题 Spring集成Mybatis的项目中，可以为指定包下的实体取别名，这样在Mapper xml文件中可以省略实体类的全路径名称，只写类名称即可；但是在多模块项目中，可能需要将实体放在不同的模块下，此时需要配置多路径扫描； 方式一：配置多个路径，逗号分隔符隔开 <!-- sqlSessionFactory spring 整合 mybatis --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFa
Mybatis 自定义SqlSessionFactoryBean扫描通配符typeAliasesPackage
hgffhh的博客
02-22 474
Mybatis 自定义SqlSessionFactoryBean扫描通配符typeAliasesPackage
MyBatis 面试题
Jsundoku的博客
03-03 1092
原理是 Mybatis 解析A标签，发现A标签引用了B标签，但是B标签尚未解析到，尚不存在，此时 Mybatis 会将A标签标记为未解析状态，然后继续解析余下的标签，包含B标签，待所有标签解析完毕，Mybatis 会重新解析那些被标记为未解析的标签，此时再解析A标签时，B标签已经存在，A标签也就可以正常解析完成了。另一种是使用嵌套查询，嵌套查询的含义为使用 join 查询，一部分列是A对象的属性值，另外一部分列是关联对象B的属性值，好处是只发一个 sql 查询，就可以把主对象和其关联对象查出来。
mapperLocations属性通配符的使用和坑 （找不到MYBATIS 配置文件）
热门推荐
book_yueguoliang的专栏
03-05 1万+
在classpath后面的*必不可少，缺少型号的话后面的通配符不起作用。 **表示可以表示任意多级目录，如：上述配置可以查到【com/huaxin/framework/system/dao/UserDaoMapper.xml】 *表示多个任意字符 注意：value="classpath*:com/huaxin/**/*Mappe...
Mybatis Plus基础06 mapperLocations配置(指定Mapper.xml文件路径)
TestingShare
05-05 6158
学习目标： 配置mapperLocations 学习产出： 1、为什么配置这个？ 截止目前为止，所有的数据操作都是依靠着BaseMapper中封装的方法来完成增删改查操作。 有些查询比如多表查询，是无法满足的，还是需要自己去写sql，就需要用到xml文件。 这个配置就相当于配置了环境变量，可直接访问到对应目录下的所有xml文件。 2、在哪里配置？ 项目中application配置文件中 //可以直观的看到mybatis下所有的xml文件 mybatis-plus.mapper-locations=cl
初识MyBatis
yfvi665的博客
08-05 846
在指定文件夹下创建application.yml文件：配置：在MyBatis的配置中，属性用于指定MyBatis映射文件的位置。这个属性告诉MyBatis到哪里去查找映射文件，这些文件包含了SQL映射语句。以下是*.xml.xml。
Springboot 多模块（A依赖B）集成mybatis , mybatis.mapper-locations 配置多个mapper路径配置
u014212540的博客
10-10 4945
最近在用SpringBoot 多模块 集成mybatis，模块A 依赖于模块B, 模块A 和模块B 各自有各自的业务逻辑和mapper 文件，模块A 的mapper xml 文件存放在resource 下的 mybatisMapper 文件夹，模块B 的mapper xm 文件存放在 B 模块的resource 下的 mapper 文件夹， 打包时以A 模块为主，B 以jar 包方式被A 依赖。当SpringBoot 应用启动时，一直 报错。
mybatis配置sqlxml模板 mapper-locations
hanjiaqian的博客
07-11 1550
mybatis配置sqlxml模板 mapper-locations
mvc 配置mapperLocations
qq_29072049的博客
07-11 2047
在网上找了好久很多方法都不全面 在pom文件里 build配置这个东西 不然你怎么扫描也扫描不到太坑了 <resources> <resource> <directory>src/main/java</directory> <includes> <include&...
无法解析配置属性 'mybatis.mapper-locations'
03-14
<think>好的，我现在需要帮助用户解决MyBatis配置中mapper-locations属性无法解析的问题。首先，我要回忆一下用户提供的引用内容，看看里面有没有相关的线索。 根据引用[1]，mapper-locations是用来指定MyBatis的映射文件位置的属性，通常在配置文件中设置。引用[2]中提到，当接口类和XML文件不在同一目录下时，可能会出现找不到mapper.xml的问题，需要正确配置mapper-locations。引用[3]和[4]讨论了classpath*和classpath的区别，以及配置的路径写法。 用户的问题是无法解析mapper-locations属性，可能的原因可能包括路径配置错误、资源未正确加载、框架版本兼容性问题，或者缓存导致的问题。接下来我需要逐一分析这些可能的原因，并给出对应的解决方法。 首先，路径配置是否正确。用户需要确认路径是否拼写正确，是否使用了正确的通配符。例如，classpath*:和classpath:的区别在于前者会搜索所有类路径，而后者只搜索第一个找到的。如果XML文件分布在多个jar包或目录中，应该使用classpath*:。另外，路径中的目录层级是否与实际存放位置一致，比如如果XML文件在src/main/resources/sql/下，那么配置应该是classpath*:sql/**/*.xml或者类似的结构。 然后是资源加载的问题。在Maven项目中，XML文件需要放在resources目录下，并且确保在构建时被正确打包到target/classes中。有时候用户可能把XML文件放在src/main/java目录下，而Maven默认不会打包该目录下的非Java文件，导致资源找不到。这时候需要在pom.xml中配置资源插件，将XML文件包含进去。 接下来是框架版本兼容性的问题。不同版本的Spring Boot或MyBatis对配置的写法可能有差异。例如，旧版本可能需要更详细的路径配置，而新版本支持更简洁的写法。用户应该检查所使用的框架版本，并查阅对应版本的文档，确保配置方式正确。 缓存问题也可能导致配置未生效。清理项目并重新构建，或者删除target目录后重新编译，可以排除缓存的干扰。此外，IDE有时会有缓存，重启IDE也可能有帮助。 其他注意事项包括检查XML文件名是否与Mapper接口对应，比如UserMapper.java对应UserMapper.xml，以及MyBatis配置文件中是否正确启用了mapperLocations属性。在Spring Boot中，通常是在application.properties或application.yml中配置，但如果是传统的MyBatis配置，需要在mybatis-config.xml中设置。 最后，如果用户还是无法解决，建议开启MyBatis的日志功能，查看详细的加载过程，从而定位问题所在。例如，在配置文件中设置日志级别为DEBUG，或者查看启动时的控制台输出，看是否有关于加载mapper文件的日志信息。 总结下来，解决方案的步骤应该是：检查路径配置是否正确，确保资源被正确加载，处理框架版本差异，清理缓存，验证XML文件命名和位置，以及查看日志定位具体错误。需要将这些步骤详细地解释给用户，并提供具体的配置示例，帮助用户逐步排查问题。</think>### 解决MyBatis配置中`mapper-locations`属性无法解析的步骤 #### 1. 检查路径配置格式 **问题原因**：`mapper-locations`的路径格式错误或未正确使用通配符。 **解决方案**： - 确保路径符合以下规范： - 使用`classpath*:`表示搜索所有类路径（包括依赖的JAR包），`classpath:`仅搜索当前模块的类路径[^3]。 - 使用`**`匹配多级目录，例如：`classpath*:/sql/**/*.xml`。 - **示例配置**（根据文件实际位置调整）： ```properties # 若XML文件在`src/main/resources/sql/`目录下 mybatis.mapper-locations=classpath*:/sql/**/*.xml # 若XML文件分散在`com/example/mapper`目录的子包中 mybatis.mapper-locations=classpath*:com/example/mapper/**/*.xml ``` #### 2. 验证资源文件是否被正确打包 **问题原因**：XML文件未被Maven/Gradle打包到`target/classes`或构建输出目录中。 **解决方案**： - 在Maven项目的`pom.xml`中添加资源声明（若XML文件在`src/main/resources`以外的目录）： ```xml <build> <resources> <resource> <directory>src/main/java</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources> </build> ``` - 检查构建后的`target/classes`目录，确认XML文件存在。 #### 3. 检查框架版本兼容性 **问题原因**：Spring Boot或MyBatis版本过旧导致配置语法不支持。 **解决方案**： - 确认Spring Boot版本（最低要求2.x以上），并在`application.properties`中检查属性名是否正确： ```properties # Spring Boot 2.x及以上 mybatis.mapper-locations=classpath*:/mappers/**/*.xml ``` - 若使用传统MyBatis（非Spring Boot集成），需在`mybatis-config.xml`中配置： ```xml <configuration> <mappers> <mapper resource="com/example/mapper/UserMapper.xml"/> </mappers> </configuration> ``` #### 4. 清理缓存并重新构建 **问题原因**：IDE或构建工具缓存导致配置未生效。 **解决方案**： - 执行清理命令（如Maven的`mvn clean install`）。 - 手动删除`target`目录并重新编译。 #### 5. 验证XML文件与Mapper接口的对应关系 **问题原因**：XML文件名未与Mapper接口一致，或未通过`<mapper namespace>`绑定。 **解决方案**： - 确保XML文件名与接口名一致（如`UserMapper.java`对应`UserMapper.xml`）。 - XML文件中需通过`namespace`声明关联的接口： ```xml <mapper namespace="com.example.mapper.UserMapper"> <!-- SQL语句 --> </mapper> ``` #### 6. 查看日志定位具体错误 **问题原因**：配置错误可能隐藏在日志中。 **解决方案**： - 在`application.properties`中开启MyBatis调试日志： ```properties logging.level.org.mybatis=DEBUG ``` - 检查启动日志，确认是否输出类似以下信息： ``` Loading XML Mapper file: file [/path/to/UserMapper.xml] ``` --- ### 总结流程图 ```mermaid graph TD A[检查路径格式] -->|路径错误| B[修正为classpath*:或通配符] A -->|路径正确| C[验证资源是否打包] C -->|未打包| D[配置pom.xml资源声明] C -->|已打包| E[检查框架版本] E -->|版本过低| F[升级Spring Boot/MyBatis] E -->|版本兼容| G[清理缓存并重试] G -->|未解决| H[查看日志定位错误] H -->|XML绑定问题| I[修正namespace或文件名] ```
评论 16
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值