Springboot整合Mybatis提示Mapper没有注入的问题

本文记录了一次SpringBoot项目开发过程中遇到的Mapper扫描不到的问题及解决过程。作者通过不断尝试并查阅文档最终发现只需在主类Application.java上添加@MapperScan注解即可解决问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

from :http://blog.youkuaiyun.com/sinat_34979383/article/details/78674433

闲来无事,想学学springboot,开始搭建一个项目,但是一直显示mapper扫描不到的错误:

这里写图片描述
“Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name ‘userController’: Unsatisfied dependency expressed through field ‘userMapper’; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type ‘com.minibike.bike.user.dao.UserMapper’ available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}”

“Field userMapper in com.minibike.bike.user.controller.UserController required a bean of type ‘com.minibike.bike.user.dao.UserMapper’ that could not be found.” 
这里写图片描述

于是在网上找解决方案,都是治标不治本,不得不说现在的博客质量下降的厉害,太误导人了,打开好多个都是一样的内容,难道没人遇到的错误一样,连包名和类名也一样吗?有的人抄别人博客,类名和包名都懒得换一下?

最后解决方案是在Application.java主类上加注解@MapperScan(“com.minibike.bike.user.dao”)。括号中引号里边是mapper所在包路径。

加上注解后不再报错,也能正常输出oooo 
这里写图片描述

第一次接触springboot,昨天下午到今早一直没找到问题所在,后来查文档、注解,然后不断尝试,最后终于解决。

当然这个只是我个人项目开发中遇到的问题解决办法,不一定通用,但是如过遇到这样的问题,也可以一试。


### Spring Boot 中 MyBatis 的 `@Mapper` 注解错误解决方案 在 Spring Boot 集成 MyBatis 时,如果遇到与 `@Mapper` 注解相关的错误,通常是因为扫描机制未能正确识别 Mapper 接口类。以下是可能的原因以及对应的解决方法: #### 原因分析 1. **未启用组件扫描** 如果项目中没有通过特定方式声明 MyBatisMapper 扫描路径,则可能导致无法找到标注有 `@Mapper` 的接口文件[^1]。 2. **依赖冲突或配置缺失** 若项目的 Maven 或 Gradle 文件缺少必要的 MyBatis-Spring-Boot-Starter 依赖项,或者版本不兼容,也可能引发此类问题[^4]。 3. **自动装配失败** 当某些 Bean 定义丢失或注入条件不符合预期时(例如服务层对象未被正确定位),会抛出类似于 `NoSuchBeanDefinitionException` 的异常[^2]。 #### 解决方案 为了妥善处理这些问题并确保正常运行,请按照以下建议调整代码结构和配置参数: ##### 方法一:全局注册 Mappers 使用 BasePackage 属性指定位置 可以通过设置 `@MapperScan` 注解来明确告知框架哪些包下的接口应视为数据访问层定义的一部分。 ```java @SpringBootApplication @MapperScan("com.example.mapper") // 替换为实际存放 mapper 接口的位置 public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } } ``` ##### 方法二:单独给每个 Mapper 加上 @Mapper 标记 虽然这种方式较为繁琐,但在小型应用里不失为一种简单有效的手段。 ```java @Repository @Mapper public interface UserMapper extends BaseMapper<User> {} ``` ##### 方法三:验证 POM.XML 是否引入合适版本库 确认 pom.xml 文件已包含如下片段,并注意保持各模块间协调一致。 ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>最新稳定版号</version> </dependency> ``` ##### 方法四:排查其他潜在干扰因素 有时第三方插件如 IDEA 自身构建过程中的临时状态也会影响最终效果,必要情况下可以尝试清理缓存重试操作[^3]。 --- ### 总结 综上所述,在面对 Spring Boot 和 MyBatis 联合开发过程中关于 `@Mapper` 注解所发生的各类状况时,需综合考虑以上几个方面逐一排除障碍直至恢复正常运作为止。
评论 20
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值