mapper-locations: classpath:generator.mapper/*.xml

<think>好的，用户的问题是关于Spring MyBatis中mapper-locations的配置，特别是关于classpath和generator.mapper/*.xml的用法。我需要先理解用户的需求，然后整理相关的信息。 首先，用户可能遇到了mapper.xml文件无法被正确加载的问题，或者在使用代码生成工具时路径配置有误。根据用户提供的引用内容，尤其是引用[1]、[2]、[3]、[4]，里面提到了不同的配置示例和常见错误，比如路径写法、通配符的使用以及可能的类转换异常。 接下来，我需要回顾MyBatis在Spring中的配置方式，尤其是mapper-locations的作用。这个配置项用来指定XML映射文件的位置，支持Ant风格的路径匹配。用户可能对classpath和classpath*的区别不太清楚，需要解释清楚。同时，generator.mapper/*.xml这样的路径可能涉及到代码生成工具生成的XML文件存放的位置，需要确认路径是否正确。 然后，常见的问题包括路径错误、通配符使用不当、文件未被正确打包到目标目录中，以及多个模块间的路径问题。例如，引用[2]中提到将XML文件移到resources/mapper目录下，并注释掉原有配置，这可能是因为路径配置错误导致文件无法加载。而引用[4]中的类转换异常可能与Mapper接口和XML文件的命名空间或类型不匹配有关，需要检查XML中的命名空间是否正确对应接口的全限定名。 此外，用户可能在使用MyBatis Generator时，生成的XML文件路径需要与mapper-locations配置一致，否则应用启动时会找不到这些文件。需要说明如何正确配置生成器的targetProject和package名称，确保XML文件生成在正确的位置，并被包含在classpath中。 最后，整理出配置的步骤、示例，以及常见问题的解决方法，帮助用户正确设置mapper-locations，避免常见的路径和配置错误。同时，生成的相关问题可以引导用户进一步排查其他潜在问题，如通配符使用、多模块配置等。</think>### MyBatis `mapper-locations` 配置详解 #### 1. 基本作用 `mapper-locations` 用于指定 MyBatis 的 XML 映射文件（`*Mapper.xml`）的路径。通过此配置，Spring Boot 会自动加载这些文件，实现 SQL 与 Java 接口的绑定[^3]。 #### 2. 配置语法 支持 Ant 风格的通配符： - `classpath:` 表示当前模块的 `resources` 目录 - `classpath*:` 表示所有模块的 `resources` 目录（适用于多模块项目） - `**` 表示多级目录 - `*` 表示单级目录或文件名通配符 #### 3. 典型配置示例 ```yaml mybatis: mapper-locations: classpath*:generator/mapper/*.xml classpath*:com/flk/mapper/**/*.xml ``` 此配置表示： 1. 加载所有模块中 `resources/generator/mapper/` 目录下的 XML 文件 2. 加载 `com.flk.mapper` 包及其子包下的 XML 文件（需配合 Maven 资源过滤） #### 4. 与代码生成的关联 若使用 MyBatis Generator： ```xml <!-- generatorConfig.xml --> <context id="example"> <jdbcConnection .../> <javaModelGenerator targetPackage="com.example.pojo"/> <sqlMapGenerator targetPackage="generator.mapper"/> <!-- 生成的 XML 路径 --> <javaClientGenerator targetPackage="com.example.dao"/> </context> ``` 需确保 `targetPackage` 与 `mapper-locations` 路径匹配[^4]。 #### 5. 常见问题解决 | 问题现象 | 解决方案 | |---------|---------| | 启动时报 `MapperException` | 检查 XML 文件的 `namespace` 是否与 Mapper 接口全限定名一致[^4] | | 报 `Invalid bound statement` | 确认 XML 文件是否被正确打包到 `target/classes` 目录 | | 多模块无法加载文件 | 使用 `classpath*:` 前缀并检查子模块资源目录配置 | | 通配符失效 | 避免在路径中使用连续 `*`，正确使用 `**/*.xml` 格式[^2] | #### 6. 验证配置有效性 在 `application.yml` 中添加： ```yaml logging: level: org.mybatis: DEBUG ``` 启动时若看到日志输出 `Parsed mapper file: 'file [...]xxxMapper.xml'` 表示配置成功。