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依賴衝突以及解決方法