1. 程式人生 > 實用技巧 >springboot2整合mybatis-plus3踩到的坑

springboot2整合mybatis-plus3踩到的坑

前言

最近在進行專案重構,在架構師的建議下,就把專案中mybatis切換成mybatis-plus。因為mybatis-plus在mybatis的基礎上只做增強不做改變,因此切換的成本很低,就只需改jar和配置內容,原先的程式碼無需改動。

因為mybatis-plus對mybatis的友好支援,我們花了一點時間就把mybatis改成mybatis-plus,那改造成不成功,先啟動一下看不就知道了。然而一啟動就翻車了,報瞭如下的錯誤

 com.baomidou.mybatisplus.core.MybatisConfiguration.getLanguageDriver(Ljava/lang/Class;)Lorg/apache/ibatis/scripting/LanguageDriver;

完整的異常資訊如下圖

排查思路

從列印的異常資訊,我們知道是不存在getLanguageDriver()這個方法。跟進原始碼會發現

getLanguageDriver這個方法可能是由

com.baomidou.mybatisplus.core.MybatisConfiguration

或者MybatisConfiguration的父類

org.apache.ibatis.session.Configuration

提供。由異常資訊我們可以猜測如果專案要啟動成功,就需要getLanguageDriver這個方法,而專案目前引用的MybatisConfiguration及其Configuration都無力提供,由此我們可以推斷我們專案引入冒牌的MybatisConfiguration或者Configuration。更進一步的推斷我們專案中應該存在多個
MybatisConfiguration或者Configuration。用人話來說,就是我們專案存在類衝突,更直白點就是jar衝突

驗證過程

1、專案中存在多個MybatisConfiguration?

按住快捷鍵Ctrl+Shift+R

很遺憾事情不是我們想的那樣,MybatisConfiguration只有一個

2、專案中存在多個Configuration?

按住快捷鍵Ctrl+Shift+R


果然存在2個Configuration。

3、驗證包衝突

利用maven-helper外掛檢視jar衝突


很明視訊記憶體在mybatis包衝突,而且我們專案引入的3.4.4版本的mybatis,而mybatis-plus需要引入的是3.5.3版本的mybatis

解決思路

藉助maven-helper外掛,我們可以看出專案是因為包傳遞依賴間接引入3.4.4版本的mybatis。因此我們把有引用3.4.4版本mybatis的專案升級成引入mybatis 3.5.3版本就行

總結

本文出現的坑挺常見的,利用搜索引擎應該都可以找到答案。寫這篇文章除了介紹如何解決這個坑,主要還是想介紹一種排查問題的思路,即假設驗證法。因為並不是每次都可以從搜尋引擎上找到答案,此時我們就可以根據已知資訊去一步步論證推斷。最後如果對maven衝突解決感興趣的朋友,可以檢視下我之前寫的文章
maven依賴衝突以及解決方法