快捷導(dǎo)航

解決springboot項(xiàng)目啟動(dòng)報(bào)錯(cuò)Field xxxMapper in com...xxxController required

更新時(shí)間：2023年12月07日 15:50:32 作者：Stephen·You

這篇文章主要介紹了解決springboot項(xiàng)目啟動(dòng)報(bào)錯(cuò)Field xxxMapper in com...xxxContr問(wèn)題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

問(wèn)題現(xiàn)象

今天在啟動(dòng)項(xiàng)目的時(shí)候發(fā)現(xiàn)了一個(gè)報(bào)錯(cuò)，如下：

Field xxxMapper in com...xxxController required a bean of type ‘com...xxxMapper‘

問(wèn)題分析

根據(jù)報(bào)錯(cuò)信息可以知道：

錯(cuò)誤原因是:xxxMapper不存在與Spring容器中'';

所以現(xiàn)在的問(wèn)題就是把xxxMapper加入到bean容器中即可.

首先查看Controller層，查看是否有以下代碼：

@Autowired
private JkMessageMapper jkMessageMapper;

上面的代碼，就是用于在實(shí)現(xiàn)了JkMessageMapper注入到bean容器后，可以自動(dòng)創(chuàng)建該類(lèi)對(duì)象，并交由bean容器管理；

通過(guò)查看xxxMapper接口，可以發(fā)現(xiàn)問(wèn)題：

因?yàn)镸apper接口類(lèi)沒(méi)有添加注解，導(dǎo)致spring容器并沒(méi)有處理到這個(gè)接口類(lèi)。

注意：

我的項(xiàng)目中是沒(méi)有dao層實(shí)現(xiàn)類(lèi)的，因?yàn)?strong>添加@Mapper注解后，spring會(huì)自動(dòng)將dao層實(shí)現(xiàn)類(lèi)創(chuàng)建并注入bean容器中；

總結(jié)：

如果用到了Controller（控制層），需要在Controller類(lèi)上添加@Controller注解；
如果用到了Service（業(yè)務(wù)層）的話(huà)，需要在Service接口類(lèi)上添加@Service注解；
如果用到了ServiceImpl（業(yè)務(wù)層實(shí)現(xiàn)類(lèi)），則需要在實(shí)現(xiàn)類(lèi)上添加@Component注解；
如果用到了MapperImpl/DaoImpl（dao層實(shí)現(xiàn)類(lèi)），則需要在實(shí)現(xiàn)類(lèi)上添加@Repository注解，但如果在dao層接口類(lèi)上添加了@Mapper注解的話(huà)，其實(shí)可以不需要dao層實(shí)現(xiàn)類(lèi)了。

解決方法

由于我這里只是忘記添加@Mapper注解了，其他配置都沒(méi)有問(wèn)題，所以只需要

在Mapper接口類(lèi)（dao層）上添加@Mapper注解：

啟動(dòng)成功：

拓展

從上門(mén)的分析可知，文章中提到的報(bào)錯(cuò)是因?yàn)閎ean對(duì)象注入失敗導(dǎo)致的，那下面再說(shuō)一下其他可能會(huì)導(dǎo)致該報(bào)錯(cuò)的原因：

1、dao層xml文件（mybatis映射文件）中 namespace屬性配置的路徑和關(guān)聯(lián)的dao層（接口類(lèi)）文件的所在目錄路徑不一致。

（提示：在IDEA默認(rèn)情況下，選擇一個(gè)dao層xml文件（mybatis映射文件），可以通過(guò)按住ctrl鍵再點(diǎn)擊映射的dao層（接口類(lèi)）快速定位到所映射的dao層類(lèi)，如果定位不到，則配置的路徑有問(wèn)題）。

2、沒(méi)有設(shè)置dao層包路徑識(shí)別注解（@MapperScan（dao層所在的包路徑））

@MapperScan 注解可以加在數(shù)據(jù)源配置類(lèi)上，或者是啟動(dòng)類(lèi)上都可以。

作用是讓spring容器在初始化時(shí)，去加載該注解所配置的包路徑下的所有dao層類(lèi)，生成對(duì)應(yīng)的bean對(duì)象。

3、沒(méi)有設(shè)置dao層xml文件（mybatis映射文件）的路徑。

假如項(xiàng)目中有數(shù)據(jù)源配置類(lèi)，那最好是配置一下dao層xml文件的路徑：

而如果沒(méi)有數(shù)據(jù)源配置類(lèi)，則需要在項(xiàng)目的 application配置文件中配置dao層xml文件的路徑：

mybatis配置：

mybatis-plus配置：

當(dāng)然還有第3種配置方法，就是通過(guò)mybatis-config.xml配置文件也可以：

然后還需要在application配置文件中添加mybatis配置文件的路徑：

強(qiáng)烈建議不要第3種方式，來(lái)配置dao層xml文件的路徑，因?yàn)槟阈枰粋€(gè)個(gè)去添加dao層xml文件（mybatis映射文件）的路徑到mybatis-config.xml文件中的mappers標(biāo)簽中，太過(guò)麻煩和繁瑣了！

初始化 SqlSessionFactory 數(shù)據(jù)源工廠對(duì)象的時(shí)候，加載該路徑，作用是在創(chuàng)建dao層類(lèi)的bean對(duì)象時(shí)，能提供一個(gè)實(shí)例對(duì)象以供初始化：