通过源码解决Field xxxMapper in xxx required a bean of type ‘xxxMapper‘ that could not be found.

最新推荐文章于 2025-03-13 09:12:02 发布
原创 最新推荐文章于 2025-03-13 09:12:02 发布 · 588 阅读 · 10 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#mybatis #java

序言

项目中我们经常会遇到这样的错误：Field userMapper in com.shiqi.mybatis.bug.demo.service.impl.UserServiceImpl required a bean of type 'com.shiqi.mybatis.bug.demo.mapper.UserMapper' that could not be found.
今天我们就一起通过源码来探究下产生的原因。

源码探究

SpringBoot 的核心就是自动装配，所以MyBatis整合Spring Boot的话，一定也会提供一个MyBatisAutoConfiguration

我们进行全局搜索找到MyBatisAutoConfiguration这个配置类，然后会发现这个类中有两个内部类：

AutoConfiguredMapperScannerRegistrar

在这里插入图片描述
通过注释我们可以看到MyBatis扫描的路径为Spring Boot启动类同级下的包。
在这里插入图片描述
我们往下看，会发现扫描路径下使用@Mapper注解的接口
在这里插入图片描述

所以上述Bug， 我们的解决方案就是在Mapper接口上加上@Mapper注解。

⚠️ 但是尤其注意的是，如果Mapper接口在不同的Maven模块中，即使使用了@Mapper 注解进行标识，也不不能扫描到。

MapperScannerRegistrarNotFoundConfiguration

在这里插入图片描述
这个内部类允许我们的mapper接口不在Spring Boot启动类同级包路径下。
在这里插入图片描述

而这个内部类只有在没有MapperFactoryBean 和 MapperScanConfigure两个类的时候生效。
在这里插入图片描述

所以如果项目是分多模块的并且Mapper接口不和SpringBoot 启动类在同一级目录下，我们通过@MapperScan注解指定扫描的路径为Mapper接口所在的包。

可以看看游艺同学的分析
MyBatis常见问题分析！源码跟踪技巧！看完你就能找到那些消失的Mapper了！

SpringBoot 报错Field XXX required a bean of type XXX that could not be found.
BADAO_LIUMANG_QIZHI的博客
03-08 3592
场景 SpringBoot项目运行时提示： 解决 首先查看service下是否有@Service注解 这里有。 然后找到启动类 修改前： 修改后： 添加： @SpringBootApplication(scanBasePackages = {"service","dao","config"}) ...
Spring第四讲：使用Spring过程中遇到的问题
Jet_qi的博客
12-03 1149
文章目录问题的来源1、坑点1 Spring Bean的定义常见错误案例1：隐式扫描不到Bean的定义案例2：定义的Bean缺少隐式依赖案例3：原型Bean被固定2、坑点2 Spring Bean依赖注入常见错误案例1：required a single bean, but 2 were found案例2：显式引用Bean时首字母忽略大小写案例3：引用内部类的Bean遗忘类名案例4：@Value没有注入预期的值案例5：@Value没有注入预期的值3、坑点3 Spring Bean.
Mybatis与springboot项目启动时出现Field mapper in ‘xxx‘ required a bean of type ‘xxx‘ that could not be found
培根芝士的专栏
11-13 3908
Mybatis与springboot项目，启动时报错，详细的错误如下： Field mapper in 'xxx' required a bean of type 'xxx' that could not be found. Action: Consider defining a bean of type ‘xxx’ in your configuration. 原因是bean装配失败，springboot扫描时没有找到@Mapper对应的接口。 解决方法： 在启动类前加上： @MapperSca
Field XXX in XXXX required a bean of type XXXX that could not be found.
热门推荐
小鹰信息技术服务部
10-17 5万+
初学SpringBoot，JPA数据查询，项目启动时报错： Field repo in com.yigo.web1.main.PersonCtrl required a bean of type 'com.yigo.web1.repo.PersonRepo' that could not be found. 摸不着头脑，提示PersonRepo这个类找不到，但是在eclipse中可以正常引
项目启动报错：Field XXX in required a bean of type ‘XXX‘ that could not be found
gaozhonghua12的专栏
08-06 4515
Error starting ApplicationContext. To display the auto-configuration report re-run your application with 'debug' enabled. 2019-08-06 16:57:34.058 [ERROR] [main] [org.springframework.boot.diagnostics....
Mapper报错：required a bean of type ‘XXXMapper‘ that could not be found
Hawk的学习笔记
09-02 7015
Description: Field scheduleMapper in com.hawk.hospital.service.impl.ApiServiceImpl required a bean of type 'com.hawk.hospital.mapper.ScheduleMapper' that could not be found. The injection point has the following annotations: - @org.springframework.beans
Parameter 2 of constructor in org.apache.dolphinscheduler.server.worker.executor.PhysicalTaskExecutorFactory required a bean of type 'org.apache.dolphinscheduler.plugin.storage.api.StorageOperator' that could not be found. The injection point has the following annotations: - @org.springframework.beans.factory.annotation.Autowired(required=true) The following candidates were found but could not be injected: - User-defined bean method 'storageOperate' in 'StorageConfiguration' ignored as the bean value is null Action: Consider revisiting the entries above or defining a bean of type 'org.apache.dolphinscheduler.plugin.storage.api.StorageOperator' in your configuration. [WI-0][TI-0] - 2025-09-24 09:04:05.770 ERROR [Worker-Server] o.a.d.c.t.DefaultUncaughtExceptionHandler:[44] - Caught an exception in Thread[Worker-Server,5,main]. org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'workerServer': Unsatisfied dependency expressed through field 'physicalTaskEngineDelegator'; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'physicalTaskEngineDelegator' defined in URL [jar:file:/opt/dolphinscheduler/libs/dolphinscheduler-worker-3.3.1.jar!/org/apache/dolphinscheduler/server/worker/executor/PhysicalTaskEngineDelegator.class]: Unsatisfied dependency expressed through constructor parameter 1; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'physicalTaskExecutorFactory' defined in URL [jar:file:/opt/dolphinscheduler/libs/dolphinscheduler-worker-3.3.1.jar!/org/apache/dolphinscheduler/server/worker/executor/PhysicalTaskExecutorFactory.class]: Unsatisfied dependency expressed through constructor parameter 2; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'org.apache.dolphinscheduler.plugin.storage.api.StorageOperator' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {}
最新发布
09-25
我们正在解决 Apache DolphinScheduler 3.3.1 中 PhysicalTaskExecutorFactory 构造函数参数 2 所需的 StorageOperator 类型的 bean 未找到的问题。 根据错误信息，Spring 在创建 PhysicalTaskExecutorFactory 的 ...
Spring Boot学习|问题汇总(一)
LJY_Qt的博客
10-02 274
Failed to configure a DataSource: 'url' attribute is not specified； ERR Client sent AUTH, but no password is set； 关于SpringDataJpa中findOne()方法报错问题； 关于SpringBoot中使用RedisCacheManager没有构造函数的问题； springboot 启动报错Field XXX required a bean of type XXX that could no
记一次 SpringBoot 项目启动失败排查 和 DubboReference 源码分析
yyyy11119的博客
12-17 375
问题现象在我们项目中有一个公司内部的二方包，里面有一个类： MvcInterceptorAutoConfiguration ，里面定一个了一个 Bean accessContextResolver 。生成这个 Bean 需要自动注入另一个 Bean ：accessContextService。代码如下：public class MvcInterceptorAutoConfiguration imp...
Field XXXMapper in 。。。a bean that could not be found.
u013394474的博客
11-15 557
如果你发现你的项目中的类或接口，该加的注解都加了，可还是报bean not found,那你就要去看看你的配置文件中的mybatis设置的包路径是否正确。 如果这里没问题，再去看看启动类上的扫描注解是否正确？ 不要粗心呀！ ...
报错Field Mapper in xxx.xxxServiceImpl required a bean of type ‘dao.xxxMapper‘ that could not be found
weixin_44377256的博客
11-29 1514
报错Field Mapper in xxx.xxxServiceImpl required a bean of type ‘dao.xxxMapper’ that could not be found 先说两个注释的区别： @Mapper不需要配置扫描地址，通过xml里面的namespace里面的接口地址，生成了Bean后注入到Service层中。 @Repository需要在Spring中配置扫描地址，然后生成Dao层的Bean才能被注入到Service层中。 方法一： @Repository改为@Ma.
Field Mapper in com...Service require a bean of type ‘com...Mapper‘ that could not be found.
hdjag的博客
03-01 1070
Field Mapper in com...Service require a bean of type 'com...Mapper' that could not be found.
mapper找不到报错：Field xxxMapper in xxx required a bean of type 'xxxMapper' that could not be found
noob9527的博客
05-10 2万+
搭建springboot项目整合ssm框架后，启动报错： Field xxxMapper in xxx.service.impl.xxxServiceImpl required a bean of type 'xxx.mapper.xxxMapper' that could not be found. The injection point has the following annotati...
Field xxxMapper in xxxController required a bean of type ‘xxxMapper‘ that could not be found解决方案
Lon9zz的博客
08-17 2802
今天在给项目添加mysql数据库的时候出了点小问题，捣弄了半小时解决了。 描述是Controller类中没有检测到本应自动装载的数据库的Mapper类。 @Controller public class HttpAPIController { //此处Mapper类应该被自动装载 @Autowired private ClientMapper clientMapper; ………… } 上网找了些资料，例如在Mapper接口中填加@Mapper.
Field XXX required a bean of type XXX that could not be found 错误
weixin_75172140的博客
06-02 539
应该是springboot版本和mybatis版本需要对应。3.0.3->2.1.1成功运行。尝试降低mybatis版本。
关于处理：required a bean of type ‘XXX‘ that could not be found.
weixin_51131291的博客
07-21 2万+
分享一个今天在代码开发时出现的问题在编写业务层的时候报了这样的一个错误，通过查找资料和自己的错误解决，总结了已下的几种情况第一种在编写dao接口文件时，忘记加上@Mapper注解其次，这个@Mapper注解不能导错包。...
SpringBoot项目启动报错：‘Field xxMapper in xxxx required a bean type ‘xx.xxMapper‘ that could not be found‘
大家一起学习！
03-13 1066
确保所使用的 Spring Boot、MyBatis、MyBatis-Plus 和其 Starter 的版本是相互兼容的。如果遇到错误，首先检查版本是否匹配，再排查具体配置问题。通过合理选择依赖版本和 Starter，可以有效避免常见的配置错误和兼容性问题。大家可自行参考！
spring boot jpa 工程出现Field XXX in XXX required a bean of type XXX that could not be found
Chen_RuiMin的博客
02-13 1975
一、序言 今天起床，继续敲打代码，于是，在一个点被绊了一下，于是就进行整理记录，本项目是采用springboot + jpa，对项目结构进行了分层，以下就是我项目结构，由于我在单项目结构并未遇到这样的情况与配置，所以我估计主要还是因为项目分层的原因 二、问题描述 项目问题从我在Controller中采用@Autowired进行自动注入时，idea却给了我这样的提示（这个提示截图不了，所以就进行了...
SpringBoot: Field xxx in xxx required a bean of type ‘xxx‘ that could not be found.
baidu_35977222的博客
03-07 233
多模块聚合注入失败 @SpringBootApplication(scanBasePackages = "com.abc 参考https://www.cnblogs.com/arebirth/p/springbootautowiredbasepackagepatherror.html")
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值