MyBatis Plus Mapper 扫描失效导致的依赖注入失败问题详解-java教程-PHP中文网

MyBatis Plus Mapper 扫描失效导致的依赖注入失败问题详解

Spring Boot 集成 MyBatis-Plus 时，因 UserMapper 接口未被 Spring 容器识别，引发 NoSuchBeanDefinitionException，根本原因是 MyBatis-Plus 的 Mapper 接口未被自动扫描注册为 Bean。

spring boot 集成 mybatis-plus 时，因 `usermapper` 接口未被 spring 容器识别，引发 `nosuchbeandefinitionexception`，根本原因是 mybatis-plus 的 mapper 接口未被自动扫描注册为 bean。

在你的项目中，虽然已为 UserMapper 添加了 @Mapper 注解，但 Spring Boot 默认不会自动扫描所有 @Mapper 接口（尤其当使用 MyBatis-Plus 时，其底层依赖 MyBatis 的扫描机制）。Spring 容器无法找到 com.wms.wms.mapper.UserMapper 类型的 Bean，因此在注入 baseMapper 字段时抛出 UnsatisfiedDependencyException。

✅ 正确解决方案：启用 Mapper 接口扫描

最推荐且稳定的方式是使用 @MapperScan 注解，在启动类上指定 Mapper 接口所在的包路径：

package com.wms.wms;

import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

// ✅ 关键：指定 Mapper 接口所在包路径
@MapperScan("com.wms.wms.mapper")
@SpringBootApplication
public class WmsApplication {
    public static void main(String[] args) {
        SpringApplication.run(WmsApplication.class, args);
    }
}

⚠️ 注意：@MapperScan("com.wms.wms.mapper") 中的包路径必须与实际 UserMapper.java 的 package 声明完全一致（即 package com.wms.wms.mapper;），且需确保该路径下所有接口均继承自 BaseMapper。

CRMEB Java开源商城 — SpringBoot + Mybatis Plus + Vue + UniApp 多端电商系统

下载

❌ 为什么仅加 @Mapper 不够？

@Mapper 是 MyBatis 原生注解，适用于单个接口，但要求每个 Mapper 接口都显式标注；
在大型项目中易遗漏，且不支持通配扫描；
更重要的是：Spring Boot 2.5+ + MyBatis-Plus 3.4+ 组合下，@Mapper 注解默认不生效，除非额外配置 mybatis.mapper-locations 或启用 @MapperScan；
你的 pom.xml 中缺失关键依赖 mybatis-plus-boot-starter —— 这是 MyBatis-Plus 自动配置和扫描能力的基础！

? 必须补充的 Maven 依赖

当前 pom.xml 中缺少 MyBatis-Plus 的核心 Starter，导致自动配置（如 MybatisPlusAutoConfiguration）未加载，进而使 @MapperScan 无法生效。请立即添加：

<dependency><groupid>com.baomidou</groupid><artifactid>mybatis-plus-boot-starter</artifactid><version>3.4.3.1</version><!-- 推荐与 Spring Boot 2.5.4 兼容的稳定版 --></dependency>

? 提示：mybatis-plus-generator 仅用于代码生成，不能替代 mybatis-plus-boot-starter；缺少它将导致 MyBatis-Plus 的自动装配、分页插件、全局配置等功能全部失效。

✅ 其他验证要点（避免踩坑）

检查 Mapper 接口是否被正确编译：确认 target/classes/com/wms/wms/mapper/UserMapper.class 存在；

确认 UserMapper 继承关系正确：

public interface UserMapper extends BaseMapper<user> { } // ✅ 正确
// 不要写成：extends Mapper<user>（这是旧版 MyBatis 写法）</user></user>

数据库驱动兼容性：你使用了 MySQL Connector/J 8.0.33，需将 application.yml 中的驱动类名更新为：
```
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver # ✅ 新版驱动类名
```
Lombok 编译支持：确保 IntelliJ IDEA 已启用 Annotation Processing（Settings → Build → Compiler → Annotation Processors → Enable annotation processing）。