Property 'mapperLocations' was specified but matching resources are not found.

### 解决 MyBatis SqlSessionFactoryBean `mapperLocations` 属性未找到匹配资源的问题 当配置 MyBatis 的 `SqlSessionFactoryBean` 时，如果指定的 `mapperLocations` 路径不正确或者无法解析到实际存在的 Mapper 文件，则会抛出类似于 “no matching resources found” 的错误提示。这通常是因为路径设置有误、文件命名不符合约定或项目打包结构问题。 以下是可能的原因分析以及解决方案： #### 可能原因及解决方法 1. **Mapper XML 文件位置不对** 如果 Mapper XML 文件不在类路径下的预期目录中，Spring 将无法定位这些文件。默认情况下，MyBatis 配置中的 `mapperLocations` 使用的是 Spring Resource Pattern Syntax 来定义路径[^1]。 - 确保 Mapper XML 文件位于项目的 `resources` 目录下，并按照包名分层存储。例如，假设有一个名为 `com.example.mapper.UserMapper.xml` 的文件，那么它应该存放在 `src/main/resources/com/example/mapper/UserMapper.xml` 下。 - 修改 `mapperLocations` 的值为对应的路径模式。例如： ```properties mybatis.mapper-locations=classpath*:com/example/mapper/*.xml ``` 2. **XML 文件名称与接口名称不一致** 当使用基于注解的方式绑定 Mapper 接口和 XML 文件时，要求 XML 文件的名字必须与接口名字完全相同（大小写敏感）。如果不一致，即使路径正确也可能找不到映射关系[^2]。 - 检查所有的 Mapper 接口及其对应的 XML 文件是否遵循这一规则。比如对于 `UserMapper.java` 接口，其关联的 XML 应命名为 `UserMapper.xml`。 3. **JNDI 名称转换失败影响上下文初始化** 错误日志提到 JNDI 查找失败的情况表明可能存在某些依赖注入未能成功完成的现象。虽然这不是直接导致 `mapperLocations` 失效的因素，但它暗示着整个应用上下文中存在其他潜在问题，这些问题可能会间接干扰到 MyBatis 的正常工作流程。 - 审核应用程序的整体配置，特别是那些涉及外部资源配置的部分，确保所有必要的组件都能够被正确定位并实例化。 4. **动态刷新机制缺失引起开发期不便** 开发阶段频繁更改 SQL 映射语句而不得不反复重启服务器确实令人沮丧。为了提高效率可以考虑引入一些插件支持实时编译功能。 - 对于 Maven 工程来说，可以通过添加如下插件实现自动重新加载效果： ```xml <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <fork>true</fork> </configuration> </plugin> </plugins> </build> ``` - 同时也可以借助工具如 JRebel 或者 DevTools 提升体验度。 ```java @Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { final SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean(); sessionFactory.setDataSource(dataSource); PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); sessionFactory.setMapperLocations(resolver.getResources("classpath*:mappers/**/*.xml")); return sessionFactory.getObject(); } ``` 以上代码片段展示了如何通过编程方式设定多个不同子目录内的 Mapper 文件作为扫描目标之一。 ---

<think>嗯，用户遇到了Spring和MyBatis整合时配置的mapperLocations找不到匹配资源的问题。我需要根据常见的解决步骤来思考如何帮助他。首先，应该检查mapper文件的存放路径是否正确。用户可能在配置中使用了类似classpath*:mapper/*.xml的路径，但实际文件可能没放在对应的目录下。例如，如果项目是Maven结构，通常需要将mapper.xml放在src/main/resources/mapper/目录下，而不是src/main/java里，否则编译时可能不会被复制到target目录中。接下来，要确认配置是否正确。在Spring的XML配置文件或者MyBatis的配置中，mapperLocations属性是否正确设置了通配符和路径。有时候路径中的星号数量或者目录层级写错了，比如写成classpath*:/mapper/**/*.xml，而实际文件在mapper下一级目录，这样可能不匹配。这时候需要调整通配符的使用方式。然后，资源标记的问题。如果用户使用的是IDEA，可能需要将存放mapper.xml的目录标记为Resources Root，这样编译时才会被包含进去。否则，即使文件存在，系统也可能找不到。特别是当用户自己创建了非标准目录时，这一步很容易被忽略。另外，检查文件扩展名是否正确。有时候文件可能被错误地命名为.txt或者其他格式，或者文件名中有多余的字符，导致模式匹配失败。例如，配置的是*.xml，但文件实际是.xml.txt，这样就不会被识别。还有，考虑是否开启了热加载或动态加载功能。引用[2]中提到，关闭Spring容器时需要终止刷新线程，可能某些动态加载配置导致资源在运行时被修改或未正确加载。需要检查是否有相关的线程或监听器干扰了资源的正常加载。最后，建议用户进行彻底的清理和重新编译，比如执行mvnclean install，确保所有资源文件都被正确打包到生成的jar或war文件中。有时候旧的编译结果残留可能导致路径错误。总结下来，解决步骤应该是：检查路径和配置是否正确，验证资源目录标记，确认文件名和扩展名，处理可能的动态加载问题，清理并重新构建项目。如果用户按照这些步骤排查，应该能解决mapperLocations找不到资源的问题。</think>### 解决Spring MyBatis `mapperLocations`未找到匹配资源的问题 #### 1. **验证资源路径配置** - **检查`mapperLocations`配置语法**：确保在Spring或MyBatis配置文件中正确指定了路径。例如： ```xml <!-- 示例：XML配置 --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="mapperLocations" value="classpath*:mapper/**/*.xml"/> </bean> ``` 若路径层级不匹配（如实际文件在`mapper/`而非`mapper/**/`），需调整通配符`**`为`*`[^1]。 - **确认资源物理路径**： - Maven项目中，应将XML文件放在`src/main/resources/mapper/`目录下。 - 非标准目录需标记为资源根（IDEA中右键目录 → **Mark Directory as → Resources Root**）[^1]。 #### 2. **检查文件命名与扩展名** - 文件名需满足通配规则（如`UserMapper.xml`而非`UserMapper.txt`）。 - 避免隐藏字符（如Windows系统下误保存为`*.xml.`）。 #### 3. **清理并重新构建项目** - 执行Maven命令清理缓存： ```bash mvn clean install ``` - 检查`target/classes/mapper/`目录下是否包含编译后的XML文件。 #### 4. **排查动态加载干扰** - 若项目中存在类似引用[2]的动态线程（如`RefreshRunnable`），需确保资源加载完成后关闭干扰线程： ```java // 示例：关闭线程的监听器 @Component public class ContainerClosedListener implements ApplicationListener<ContextClosedEvent> { @Override public void onApplicationEvent(ContextClosedEvent event) { RefreshRunnable.closeReloadThread(); // 终止资源刷新线程 } } ``` #### 5. **验证配置兼容性** - Spring Boot项目中，改用`mybatis.mapper-locations`配置： ```properties # application.properties mybatis.mapper-locations=classpath*:mapper/**/*.xml ``` ---