<think>我们正在解决
Spring Boot
整合MyBatis时自定义
Mapper无法被识别的
问题。
根据引用内容，我们可以通过多种方式配置
MyBatis的
Mapper扫描。以下是几种常见解决方法：
1. **
使用@
MapperScan注解**：在
Spring Boot启动类上添加`@
MapperScan`注解，指定
Mapper接口所在的包路径。例如：
```java
@
SpringBootApplication
@
MapperScan("com.example.
mapper") // 指定
Mapper接口所在的包
public class Application {
public static vo
id main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
```
2. **
使用@
Mapper注解**：在每个
Mapper接口上直接添加`@
Mapper`注解，这样
Spring Boot会自动识别。例如：
```java
@
Mapper
public interface User
Mapper {
@Select("SELECT * FROM user")
List<User> findAll();
}
```
3. **配置
mapper-locations**：如果
使用XML文件定义SQL，需要在`application.properties`中配置XML文件的位置。例如：
```properties
mybatis.
mapper-locations=classpath*:
mapper/**/*.xml
```
4. **检查包扫描范围**：确保
Mapper接口所在的包在
Spring Boot主应用的子包下，或者被`@
MapperScan`明确指定。
5. **检查依赖**：确保项目中已正确引入
MyBatis和Spring Boot
整合依赖，例如：
```xml
<dependency>
<group
Id>org.
mybatis.
spring.boot</group
Id>
<artifact
Id>
mybatis-
spring-boot-starter</artifact
Id>
<version>2.2.0</version>
</dependency>
```
6. **检查接口方法定义**：确保自定义
Mapper方法有正确的SQL注解或对应的XML文件（见引用[2][3]）。如果
使用XML，需要确保XML文件路径配置正确。
7. **检查
IDEA配置**：如果
使用IntelliJ
IDEA，有
时需要标记资源目录。确保XML文件放在`src/main/resources`下，且被正确识别为资源文件。
8. **
通用Mapper插件**：如果
使用通用Mapper（见引用[4]），需要配置`@
MapperScan`的`markerInterface`属性指向
通用Mapper接口。
**示例配置：**
```java
// 启动类配置
@
MapperScan(basePackages = "com.example.dao", markerInterface = My
Mapper.class)
public class Application { ... }
```
请
根据实际情况选择合适的方法进行排查。
§§相关
问题§§
1. 如何配置
MyBatis的XML映射文件路径？
2.
Spring Boot中如何
使用@
MapperScan扫描多个包？
3.
通用Mapper插件在
Spring Boot中如何
整合？</think>###
Spring Boot
整合MyBatis自定义
Mapper无法识别的解决方法
在
Spring Boot
整合MyBatis时，自定义
Mapper无法被识别通常是由于扫描配置
问题导致的。以下是具体解决步骤：
#### 1. **
使用`@
MapperScan`注解全局扫描**
在启动类添加注解指定
Mapper接口的包路径：
```java
@
SpringBootApplication
@
MapperScan("com.example.
mapper") // 替换为你的
Mapper接口包名
public class Application {
public static vo
id main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
```
> **关键点**：`@
MapperScan`会扫描指定包下所有
Mapper接口[^4]。
#### 2. **为每个
Mapper接口添加`@
Mapper`注解**
在每个自定义
Mapper接口上单独添加注解：
```java
@
Mapper // 声明为
MyBatis组件
public interface Custom
Mapper {
@Select("SELECT * FROM table WHERE column = #{value}")
List<Entity> customQuery(String value);
}
```
#### 3. **配置XML映射文件路径**
在`application.properties`中配置XML文件位置：
```properties
# 配置XML映射文件路径
mybatis.
mapper-locations=classpath*:
mapper/**/*.xml
```
支持模糊匹配路径格式：`classpath*:com/package/**/mapping/*.xml`[^3]
#### 4. **检查接口与XML的对应关系**
确保XML配置正确绑定接口：
```xml
<!-- resources/
mapper/Custom
Mapper.xml -->
<
mapper namespace="com.example.
mapper.Custom
Mapper">
<select
id="customMethod" resultType="com.example.Entity">
SELECT * FROM table WHERE
id = #{
id}
</select>
</
mapper>
```
> **注意**：`namespace`必须与
Mapper接口全限定名完全一致[^2]。
#### 5. **验证依赖配置**
检查`pom.xml`是否包含必要依赖：
```xml
<dependency>
<group
Id>org.
mybatis.
spring.boot</group
Id>
<artifact
Id>
mybatis-
spring-boot-starter</artifact
Id>
<version>2.2.0</version> <!--
使用最新版本 -->
</dependency>
```
#### 6. **项目结构规范示例**
```
src/main/java
└─ com.example
├─ Application.java # 包含@
MapperScan的启动类
└─
mapper
└─ Custom
Mapper.java #
Mapper接口
src/main/resources
└─
mapper
└─ Custom
Mapper.xml # XML映射文件
```
> **常见错误排查**：
> 1. 检查`@
MapperScan`包路径是否包含
Mapper接口
> 2. 确认XML文件在`resources`目录且路径匹配`
mapper-locations`
> 3. 确保接口方法名与XML中的`
id`一致
> 4.
重启
IDE（有
时IDE缓存
导致扫描失败）
通过以上步骤，99%的自定义
Mapper识别
问题都能解决。若仍存在
问题，建议检查
MyBatis日志级别：
```properties
logging.level.org.
mybatis=DEBUG
```
扫一扫
5986
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
