mybatis无法找到mapper

### MyBatis无法加载Mapper XML文件的原因分析 当遇到MyBatis无法加载`mapper.xml`的情况时，通常是因为配置不正确或路径设置错误。以下是可能导致此问题的一些常见原因以及解决方案。 #### 配置类路径资源未找到 如果`mybatis-config.xml`中的映射器位置指定有误，则可能会导致找不到对应的XML文件。确保在`mybatis-config.xml`中正确定义了扫描包的位置[^1]： ```xml <mappers> <package name="com.example.mapper"/> </mappers> ``` 对于Spring Boot项目而言，在application.properties 或 application.yml 文件里也需要指明相应的路径: ```properties # application.properties mybatis.mapper-locations=classpath*:mapper/*.xml ``` 或者YAML格式下： ```yaml # application.yml mybatis: mapper-locations: classpath*:mapper/**/*.xml ``` #### Mapper接口与XML文件名不符 另一个常见的问题是Mapper接口名称和其关联的`.xml`文件的名字并不匹配。为了使它们能够自动配对，这两个名字应该保持一致(除了扩展名外)，并且位于相同的目录结构内[^3]。 例如，如果有如下Java接口定义： ```java public interface UserMapper { } ``` 那么相对应的地图文件应当命名为 `UserMapper.xml`, 并放置在同一级别的resources下的相应子文件夹中。 #### 资源不在编译后的ClassPath范围内 有时开发者会把SQL Map文件放在src/main/resources之外的地方，这会造成打包之后这些文件并没有被打入最终JAR/WAR包内的class path里面去。因此运行期就找不见那些必要的Map文件了。所以要确认所有的`*.xml`都处于项目的resource根目录之下或是被包含进了构建工具（如Maven）所管理的标准输出路径之中[^2]。 ---