springboot 2.0 mybatis mapper-locations扫描多个路径

最新推荐文章于 2025-11-15 14:10:51 发布
原创 最新推荐文章于 2025-11-15 14:10:51 发布 · 3.5w 阅读 · 22 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#springboot #mybatis #mapper-locations

本文详细介绍了MyBatis框架中mapper-locations属性的使用方法，如何通过该属性扫描多个路径下的mapper.xml文件，包括源码包下的资源文件。同时，文章还提及了type-aliases-package的配置以及一些MyBatis的高级设置，如自动映射下划线到驼峰命名、SQL语句的日志输出等。

mapper-locations扫描多个路径，中间以,分开，

如果mapper.xml在源码包下，配置成classpath*开头比较好使

mybatis:
  mapper-locations: classpath*:mapper/*.xml,classpath*:com/urthink/upfs/**/*Mapper.xml
  type-aliases-package: com.urthink.upfs.springbootmybatis.entity
  #IDENTITY: MYSQL #取回主键的方式
  #notEmpty: false #insert和update中，是否判断字符串类型!=''
  configuration:
    #进行自动映射时，数据以下划线命名，如数据库返回的"order_address"命名字段是否映射为class的"orderAddress"字段。默认为false
    map-underscore-to-camel-case: true
    # 输出SQL执行语句 （log4j2本身可以输出sql语句）
    #log-impl: org.apache.ibatis.logging.stdout.StdOutImpl #这种带结果集

maven 打包源码包下的资源文件，如xml
https://blog.youkuaiyun.com/haveqing/article/details/86624255

SpringBoot 整合mybatis，mybatis-plus
congge_study的博客
06-23 2万+
SpringBoot 整合mybatis，mybatis-plus
《程序猿入职必会（10） · SpringBoot3 整合 MyBatis-Plus》
山人行
08-07 3849
本系列博文已连载到第10篇，在前几篇文章基础上，我们已经得到了一个完整的前后端项目，并且后端已经接入了MyBatis 完成了教师表的 CURD 操作，本篇文章在此基础上，整合，从而进一步强化功能。《程序猿入职必会（1） · 搭建拥有数据交互的 SpringBoot 》《程序猿入职必会（2） · 搭建具备前端展示效果的 Vue》《程序猿入职必会（3） · SpringBoot 各层功能完善 》《程序猿入职必会（4） · Vue 完成 CURD 案例 》《程序猿入职必会（5） · CURD 页面细节规范 》
springBoot 双数据源配置 （Oracle+ SQL sever）主数据源配置setMapperLocations多个路径
Sum
09-17 2085
1.添加pom依赖 （部分） <!--添加 阿里连接池 支持--> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid-spring-boot-starter</artifactId> <version>1.1.10</version>
MyBatis-Plus——超详细讲解配置文件
HD243608836的博客
09-05 1万+
在我们的【MyBatis-Plus】中有许多【配置】，也就是当我们需要用到的时候，会在配置文件中进行编写的属性，本篇博客将会讲解这些配置的【作用】，以及简单【使用】。
SpringBoot详解
最新发布
2509_94007466的博客
11-15 933
因此，把应用的主类放在根包中，SpringBoot就会自动扫描并加载所有需要的组件和配置，让你可以专注于编写业务代码，而不用担心复杂的配置细节。Spring提供了大量的子模块，如Spring Core、Spring Web、Spring Data等，但它们的配置复杂度较高，且需要开发者手动配置各类文件和依赖。启用了SpringBoot的自动配置功能，SpringBoot会根据项目中的依赖，自动配置很多常用的 Spring组件，这样就不需要手动配置它们。目录下，提供了默认的配置。
mybatis mapper-locations作用
qq_35091353的博客
08-19 1万+
1、mapper-locations mapper-locations是一个定义mapper接口位置的属性，在xxx.yml或xxx.properties下配置，作用是实现mapper接口配置 2、使用场景 当mapper接口和mapper接口对应的配置文件在 命名上相同 、所在的路径相同，则mapper-locations可以不用配置，配置也不会生效。 如果mapper接口和mapper接口对应的配置文件在命名上不同或所在的路径不同，配置mapper-locations才能实现接口的绑定。实现m
mybatis.mapper-locations 配置多个mapper路径
热门推荐
lockie的博客
03-19 17万+
springboot或者spring项目经常会引用其它项目，把其它项目的Jar包加进来，因为每个项目的包路径不一样,mapper.xml的路径也不一样，这个时候就需要引入多个路径。 项目A，mapper.xml 路径在 resources/mappers/push 下面 项目B，mapper.xml 路径再 resources/mappers/下面 项目A引用了项目B，把项目B的jar包加入...
SpringBoot中mapper-locations配置多个mapper包路径
见证自己学习,成长的记录
12-16 1万+
SpringBoot中mapper-locations配置多个mapper包路径
springboot整合mybatis以及mybatis-plus 开发
m0_68041576的博客
08-13 1617
MyBatis最佳搭档，只做增强不做改变，为简化开发、提高效率而生。详细信息请看官方文档MyBatis-Plus 🚀 为简化开发而生。
SpringBoot3整合MyBatis-Plus
m0_46496775的博客
04-21 1839
MyBatis-Plus 提供了一个 ConfigurationCustomizer 接口，允许我们在 MyBatis 的配置过程中进行自定义配置。通过实现这个接口，我们可以对 MyBatis 的 Configuration 对象进行自定义配置。在 Spring Boot 容器中放入一个 ConfigurationCustomizer 组件并实现自定义配置。在 Spring Boot 启动类中添加 @MapperScan 注解，扫描 mapper 文件夹。
详解mybatis-plus的 mapper.xml 路径配置的坑
09-07
综上所述，解决Mybatis-Plus mapper.xml文件未被读取的问题，需要仔细检查以下几个方面：接口命名、Mapper扫描路径、XML文件位置、配置属性以及XML文件内容的正确性。通过逐一排查和调整，通常可以找到问题所在并...
Springboot 多模块（A依赖B）集成mybatis , mybatis.mapper-locations 配置多个mapper路径配置
u014212540的博客
10-10 5154
最近在用SpringBoot 多模块 集成mybatis，模块A 依赖于模块B, 模块A 和模块B 各自有各自的业务逻辑和mapper 文件，模块A 的mapper xml 文件存放在resource 下的 mybatisMapper 文件夹，模块B 的mapper xm 文件存放在 B 模块的resource 下的 mapper 文件夹， 打包时以A 模块为主，B 以jar 包方式被A 依赖。当SpringBoot 应用启动时，一直 报错。
spring-mybatis.xml 里mapperLocations 配置多路径
lovesman的博客
04-02 1778
<property name="mapperLocations"> <array> <value>classpath*:mapper-offline/*Mapper.xml</value> <value>classpath*:mapper-offline/bussiness-offline/*Mapper.xml</value> </array> </property..
Mybatis的mapper-locations配置多个mapper路径
zx20110729的博客
04-10 2万+
一、 在spring中使用 在创建SqlSessionFactoryBean中指定参数，代码如下: @Bean public SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource) throws IOException { SqlSessionFactoryBean bean = new SqlSessionFactoryBean(); ResourcePatternResol
mybatis配置mapperLocations多个路径
weixin_34313182的博客
03-21 2988
&lt;property name="mapperLocations"&gt; &lt;array&gt; &lt;value&gt;classpath*:/mybatis-config.xml&lt;/value&gt; &lt;value&gt;classpath*:/com/**/sqlmap-*.xml&lt;/value&gt;
MybatisPlus中多个mapper路径配置
ZhaZha_Yi的博客
06-30 1821
【代码】MybatisPlus中多个mapper路径配置。
mybatis.mapper-locations 包含jar包文件配置多个mapper路径
javashareauthor的博客
07-17 5685
在一次的公司项目微服务化的时候，遇到一个问题：项目A中带有mapper.xml文件，项目B中也有其他的mapper.xml。这个时候项目A在某些场景的情况下需要把B打成JAR包引入到A，那么这个时候两个项目的包路径不一致，,mapper.xml的路径也不一样，这个时候就需要引入多个路径。 项目A:mapper.xml 路径在 resources/mybatis/mapper/push 下面 mybatis-plus: mapper-locations: classpath:mybatis/*.xm
mybatis设置一个或多个mapper.xml路径
m0_56161419的博客
05-21 1620
（告诉 Mapper 所对应的 XML 文件位置）多个目录用逗号或者分号分隔。
多个路径 mybatis-plus.mapper-locations=classpath*:
09-29
<think>嗯，用户这次想了解MyBatis-Plus中mapper-locations配置多个路径的具体方法和注意事项。从用户提供的引用资料来看，用户应该是个Java开发者，可能在使用MyBatis-Plus时遇到了多路径配置的问题。 用户可能是从某个教程或者文档中看到了相关配置，但对具体细节不太清楚。考虑到用户引用了四篇相关文章，特别是引用[3]明确提到了多路径配置的示例，这说明用户已经做过一些调研，现在需要更系统性的解答。 在技术细节上，我需要重点说明两点：一是多路径配置的语法格式，这在引用[3]的yml配置示例中展示得很清楚；二是路径匹配规则，特别是classpath和classpath*的区别，这是容易踩坑的地方。用户提供的引用[4]提到配置失效的问题，正好可以用来提醒注意事项。 用户可能还隐含想知道如何验证配置是否生效，所以需要补充单元测试的方法。引用[1]和[2]提到的starter依赖差异也很重要，不同依赖会导致配置前缀不同，这个坑必须强调。 回复结构应该这样组织：先给出标准的多路径配置示例（yml和properties两种格式），然后解释路径匹配规则，接着重点说明注意事项，最后给个验证方案。注意事项部分要把依赖差异、通配符使用、路径重叠这些关键点都覆盖到。 值得一提的是，用户引用的资料里有篇原文链接是收费提示，说明用户可能遇到资料获取障碍，所以回答时要尽量把核心内容解释透彻，避免让用户再去查找碎片化资料。 </think>在 MyBatis-Plus 中配置多个 `mapper-locations` 路径用于扫描 XML 映射文件是常见需求，以下是详细方法和注意事项： --- ### **一、配置多个路径的方法** 在 `application.yml` 或 `application.properties` 中，使用数组形式列出多个路径即可。 #### **1. YAML 格式配置** ```yaml mybatis-plus: mapper-locations: - classpath:mapper/module1/**/*.xml - classpath:mapper/module2/**/*.xml - classpath*:com/example/custom/**/*Mapper.xml ``` #### **2. Properties 格式配置** ```properties # 多个路径用逗号分隔 mybatis-plus.mapper-locations=\ classpath:mapper/module1/**/*.xml,\ classpath:mapper/module2/**/*.xml,\ classpath*:com/example/custom/**/*Mapper.xml ``` --- ### **二、关键注意事项** 1. **依赖差异导致的前缀问题** - **依赖 `mybatis-plus-boot-starter`** → 使用 `mybatis-plus.mapper-locations` - **依赖原生 `mybatis-plus`** → 使用 `mybatis.mapper-locations` *配置错误会导致 XML 文件无法加载*[^1][^2]。 2. **`classpath` vs `classpath*`** - `classpath:`：仅扫描当前模块的类路径（不包含依赖 Jar 包）。 - `classpath*:`：扫描所有模块（含依赖 Jar 包）的类路径。 *多模块项目或依赖第三方 Mapper 时需用 `classpath*:`*[^3]。 3. **通配符规则** - 单级目录：`*`（如 `mapper/*.xml`） - 多级目录：`**`（如 `mapper/**/*.xml`） 4. **路径重叠问题** - 避免路径重复包含（如 `mapper/**/*.xml` 和 `mapper/user/*.xml` 可能导致重复加载）。 5. **Nacos 配置中心兼容性** - 在 Nacos 中配置时，确保 `mapper-locations` 的缩进正确（YAML 需对齐），否则配置无效[^4]。 6. **路径大小写敏感** - **Linux 系统路径区分大小写**，需确保配置路径与实际目录大小写一致。 --- ### **三、验证配置是否生效** 1. 开启 MyBatis-Plus SQL 日志： ```yaml mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl ``` 2. 执行单元测试，检查日志： - 若出现 `Mapped Statements` 加载数量，表示配置成功。 - 若提示 `BindingException: Invalid bound statement`，需检查路径匹配规则。 --- ### **四、典型问题排查** | **现象** | **解决方案** | |-------------------------|---------------------------------------| | XML 文件未被加载 | 检查依赖前缀、路径通配符、文件后缀 | | 多模块扫描失败 | 使用 `classpath*:` 替代 `classpath:` | | Nacos 配置不生效 | 确认 YAML 缩进与本地配置一致[^4] | | 日志无 SQL 输出 | 检查 `log-impl` 配置是否开启 | --- ### **配置示例对比** ```yaml # ✅ 正确配置（多路径 + classpath*） mybatis-plus: mapper-locations: - classpath:mapper/**/*.xml - classpath*:com/lib/**/*Mapper.xml # ❌ 错误配置（路径未用数组格式） mybatis-plus.mapper-locations=classpath:mapper/*.xml, classpath:com/*/mapper/*.xml ``` > **总结**：多路径配置需注意 **依赖前缀**、**路径匹配规则** 和 **通配符语法**，尤其在多模块或云配置环境下需严格验证路径有效性。建议通过单元测试和日志输出双重验证[^1][^3][^4]。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值