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

<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 ``` ---