Spring Boot项目中UserMapper Bean无法注入问题求助

1. 确认Mapper类的注解配置 #

• 必须保证UserMapper接口上添加了@Mapper注解，或者在项目启动类上通过@MapperScan指定Mapper所在的包路径：

  // 方式一：在UserMapper接口上添加注解
  @Mapper
  public interface UserMapper {
      // 你的Mapper方法
  }
  
  // 方式二：在启动类上批量扫描Mapper包
  @SpringBootApplication
  @MapperScan("com.inn.project.mappers")
  public class ProjectApplication {
      public static void main(String[] args) {
          SpringApplication.run(ProjectApplication.class, args);
      }
  }
  

• 若使用MyBatis-Plus，上述两种方式同样适用，无需额外修改。

2. 验证包扫描范围 #

• Spring Boot启动类默认扫描自身所在包及其子包，确认UserMapper所在的com.inn.project.mappers是否属于启动类的扫描范围。如果启动类不在com.inn.project包下，必须通过@MapperScan显式指定路径。

3. 检查依赖完整性 #

• 确认pom.xml中已正确引入MyBatis/MyBatis-Plus的Spring Boot Starter依赖：

  <!-- MyBatis Starter 示例 -->
  <dependency>
      <groupId>org.mybatis.spring.boot</groupId>
      <artifactId>mybatis-spring-boot-starter</artifactId>
      <version>2.2.2</version> <!-- 使用适配你Spring Boot版本的版本号 -->
  </dependency>
  
  <!-- MyBatis-Plus Starter 示例 -->
  <dependency>
      <groupId>com.baomidou</groupId>
      <artifactId>mybatis-plus-boot-starter</artifactId>
      <version>3.5.3.1</version> <!-- 使用适配你Spring Boot版本的版本号 -->
  </dependency>
  

• 同时确保数据库驱动依赖（如MySQL）已正确引入，避免因依赖缺失导致Mapper无法被实例化。

4. 核对Service层的注入配置 #

• 检查UserService中注入UserMapper的代码，确保注解（@Autowired或@Resource）使用正确，且Mapper的类路径、变量名无拼写错误：

  @Service
  public class UserService {
      @Autowired
      private UserMapper userMapper; // 确认此处路径和名称与Mapper类一致
  
      // 你的业务方法
  }
  

5. 检查编译产物 #

• 查看项目编译后的target/classes/com/inn/project/mappers目录下是否存在UserMapper.class文件。若不存在，执行mvn clean install（或IDE的clean+重新编译）操作，修复编译问题。

6. 排除Spring Security干扰 #

• 暂时移除Spring Security相关配置类或依赖，启动项目验证是否能正常创建Bean。若移除后可正常启动，再逐步添加Security配置，排查是否存在Bean加载顺序或配置冲突问题。

内容的提问来源于stack exchange，提问作者Karol