package com.itheima.springbootmybatis.mapper; import com.itheima.springbootmybatis.pojo.User; import org.apache.ibatis.annotations.Mapper; import org.apache.ibatis.annotations.Select; //@Mapper public interface UserMapper { @Select("select * from user where id = #{id}") public User findById(Integer id); } 报错Error starting ApplicationContext. To display the condition evaluation report re-run your application with 'debug' enabled. 2025-07-01T11:16:16.464+08:00 ERROR 11596 --- [ main] o.s.b.d.LoggingFailureAnalysisReporter : *************************** APPLICATION FAILED TO START *************************** Description: Field userMapper in com.itheima.springbootmybatis.service.impl.UserServiceImpl required a bean of type 'com.itheima.springbootmybatis.mapper.UserMapper' that could not be found. The injection point has the following annotations: - @org.springframework.beans.factory.annotation.Autowired(required=true) Action: Consider defining a bean of type 'com.itheima.springbootmybatis.mapper.UserMapper' in your configuration. 进程已结束，退出代码为 1

### 3.1 使用 `@MapperScan` 注解统一注册 Mapper 接口 Spring Boot 整合 MyBatis 时，通过 `@MapperScan` 注解可以自动扫描并注册所有 Mapper 接口为 Spring 容器中的 Bean。该注解通常标注在启动类或配置类上，并指定要扫描的包路径： ```java import org.mybatis.spring.annotation.MapperScan; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication @MapperScan("com.itheima.springbootmybatis.mapper") public class SpringbootMyBatisApplication { public static void main(String[] args) { SpringApplication.run(SpringbootMyBatisApplication.class, args); } } ``` 通过上述方式，无需在每个 Mapper 接口上单独添加 `@Mapper` 注解，避免因重复注册导致的冲突问题 [^1]。 --- ### 3.2 确保 MyBatis Starter 版本与 Spring Boot 兼容 版本不兼容是导致 Mapper 接口无法正确注册的重要原因。例如，在使用 Spring Boot 3.x 的项目中，若引入的是旧版 `mybatis-spring-boot-starter`（如 2.x），可能会出现类型转换异常或 Bean 定义错误等问题。 推荐使用与 Spring Boot 主版本匹配的 MyBatis Starter 版本，例如对于 Spring Boot 3.5.x，建议依赖如下版本： ```xml <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.0.3</version> </dependency> ``` 确保 MyBatis 相关依赖与 Spring Boot 核心库保持一致，有助于避免接口代理生成失败、Bean 类型识别错误等运行时问题 [^1]。 --- ### 3.3 避免手动注册 Mapper 接口为普通 Bean MyBatis 会自动为每个 Mapper 接口生成代理类并注册为 Spring Bean。如果开发者在接口上误加了 `@Component`、`@Repository` 或其他用于注册 Bean 的注解，会导致 Spring 尝试将其作为普通 Bean 处理，从而引发类型不匹配异常。 应仅保留如下形式的 Mapper 接口定义： ```java package com.itheima.springbootmybatis.mapper; import org.apache.ibatis.annotations.Select; public interface UserMapper { @Select("select * from user where id = #{id}") User findById(Integer id); } ``` 不应手动添加任何非 MyBatis 注解来注册此类接口为 Spring Bean [^1]。 --- ### 3.4 清理构建缓存以排除残留编译文件干扰 有时历史编译文件可能残留在 `target/classes` 或 Maven/Gradle 缓存目录中，造成 Spring 加载了错误的类定义。执行清理命令可有效避免此类问题： ```bash mvn clean install ``` 或使用 Gradle： ```bash gradle clean build ``` 确保所有类文件均为最新构建结果，有助于解决因残留文件导致的 Bean 注册失败问题 [^1]。 --- ### 3.5 检查自定义 FactoryBean 实现是否返回正确的 Class 类型 若项目中存在自定义的 `FactoryBean` 实现用于创建 Mapper 实例，需确保其 `getObjectType()` 方法返回的是实际的 `Class<?>` 类型，而非字符串或其他类型。例如： ```java @Override public Class<?> getObjectType() { return UserMapper.class; // 必须返回 Class 类型 } ``` 若误将该方法返回值设为字符串形式的类名（如 `"com.itheima.springbootmybatis.mapper.UserMapper"`），则会触发 `BeanDefinitionStoreException` 异常 [^1]。 --- ###