SpringBoot3整合MyBatis報錯:Property ‘sqlSessionFactory‘ or ‘sqlSessionTemplate‘ are required

来源:https://www.cnblogs.com/han-1034683568/archive/2022/11/24/16920607.html
-Advertisement-
Play Games

遇到了一個 Spring Boot 3 整合 MyBatis 的問題,然後解決了。當然,這其實不是個大問題,只是自己編碼時遇到了,然後總結總結分享一下。如果有遇到類似問題的,可以參考一下。 交代一下背景 最近在熟悉 Spring Boot 3 版本的代碼,開發過程中遇到了一些小坑,不過很快都解決了。 ...


遇到了一個 Spring Boot 3 整合 MyBatis 的問題,然後解決了。當然,這其實不是個大問題,只是自己編碼時遇到了,然後總結總結分享一下。如果有遇到類似問題的,可以參考一下。

交代一下背景

最近在熟悉 Spring Boot 3 版本的代碼,開發過程中遇到了一些小坑,不過很快都解決了。然後就用 Spring Boot 3 版本寫了幾個小 demo,比如 Web 開發、連接資料庫、使用 JdbcTemplate 操作資料庫,編碼和測試都非常順利,雖然是從 Spring Boot 2.x 版本升級到 Spring Boot 3,但是沒有感覺到太多差別。

不過,在使用 Spring Boot 3 整合 MyBatis 時出現了一些問題,花了不少時間處理。

使用的版本如下所示。

  • Spring Boot 版本配置
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.0.0-SNAPSHOT</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>
  • MyBatis 版本配置
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>2.2.2</version>
</dependency>

問題出現

啟動時直接報錯,內容如下圖所示。

當然,異常信息挺多,比如無法創建 Bean 的異常等等,不過上面的幾個異常並不是問題主因。這裡我直接定位到最後的異常上,異常信息是:

Caused by: java.lang.IllegalArgumentException: Property 'sqlSessionFactory' or 'sqlSessionTemplate' are required

跟入發生異常的地方,代碼截圖如下:

問題原因也很明顯,sqlSessionTemplate 對象是空的。

問題排查

當然,由於把 Spring Boot 版本升級到 3 了,所以會覺得有很大的可能是版本升級導致了問題。

不過還是想自己查查問題,就依次檢查了代碼、資料庫配置、MyBatis 配置,都沒有發現哪裡寫錯了,接著就沒頭緒了。之後又看了一下 MyBatis 自動配置的源碼,通過 debug 模式看了下是不是有什麼問題,在查看源碼的過程中看到一個有意思的事情,SqlSessionFactoryBean 這個類直接報紅了,如下圖所示。

為什麼說有意思呢?

正常情況下這個類肯定不會報錯的。再去查詢問題,發現 NestedIOException 這個類在 Spring 6 版本中直接刪除了。對的,直接刪除了。而 MyBatis 還沒有同步更新,所以直接就報紅了。

如果真的是版本升級導致的,還真就暫時沒法改,只能等 MyBatis 那邊也發佈新版本才行。除了 MyBatis 之外,如果使用 Spring Boot 3 直接整合 MyBatis-Plus 這種框架,那肯定也會報錯的。

另外,不止是 MyBatis 框架會出問題。像 Spring 6 這種直接嘎掉一些類的情況,如果其它框架里用到了一些 Spring 框架中的類,恰好也被嘎了。那麼,升級到 Spring6 或者 Spring Boot 3 時,都得註意一下。

解決問題:需要升級版本

好的,排查自己的代碼沒發現問題。只有去古狗上看看有沒有解決方案,搜了一圈,在 MyBatis 的開源倉庫里看到了一個類似問題,解決方案也有,如下圖所示。

對的,使用 Spring Boot 3 版本整合 MyBatis 時,需要把 mybatis-spring-boot-starter 也升級。mybatis-spring-boot-starter 2.x 版本暫時還不適配 Spring Boot 3 版本,沒轍。另外,由於還沒正式發版,所以需要配置一個遠程倉庫。

<dependencies>
    <!-- 引入 3.0.0-SNAPSHOT 版本的 mybatis-spring-boot-starter(未正式發版) -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>3.0.0-SNAPSHOT</version>
    </dependency>
</dependencies>
<repositories>
    <!-- 由於未正式發版,所以在Maven倉庫里還搜不到,需要額外配置一個遠程倉庫 -->
    <repository>
        <id>ossrh</id>
        <name>OSS Snapshot repository</name>
        <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

總結

事情不大,本來不想單獨寫篇文章的,但是我有個預感,在項目中升級 Spring Boot 3 時還會有其它問題。不知道 Spring6 這次更新了多少東西,連 TM 的MyBatis、MyBatis-Plus 這種常用的框架都中招了。這些就慢慢整理吧,畢竟是大版本升級,難免會出現不相容、等依賴更新的情況。確實沒轍,等更新唄。

如果這篇文章浪費了你的時間,先說聲抱歉,你直接關掉網頁就好。

因為維護了幾個 Spring Boot 的開源項目,Spring Boot 3 正式發版了,我也會及時更新版本、升級這幾個 Spring Boot 實戰項目。如果碰到了什麼問題,也會及時分享出來。

項目名稱 描述 GitHub倉庫地址 Gitee倉庫地址
newbee-mall Spring Boot 開源電商實戰項目(含商城端和後臺管理系統) https://github.com/newbee-ltd/newbee-mall https://gitee.com/newbee-ltd/newbee-mall

項目名稱 描述 GitHub倉庫地址 Gitee倉庫地址
My-Blog Spring Boot 開源博客實戰項目 https://github.com/ZHENFENG13/My-Blog https://gitee.com/ZHENFENG13/My-Blog

除註明轉載/出處外,皆為作者原創,歡迎轉載,但未經作者同意必須保留此段聲明,且在文章頁面明顯位置給出原文鏈接,否則保留追究法律責任的權利。

我曾七次鄙視自己的靈魂:
第一次,當它本可進取時,卻故作謙卑;
第二次,當它空虛時,用愛欲來填充;
第三次,在困難和容易之間,它選擇了容易;
第四次,它犯了錯,卻藉由別人也會犯錯來寬慰自己;
第五次,它自由軟弱,卻把它認為是生命的堅韌;
第六次,當它鄙夷一張醜惡的嘴臉時,卻不知那正是自己面具中的一副;
第七次,它側身於生活的污泥中雖不甘心,卻又畏首畏尾。
您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Vue CartView.vue script 數組的filter函數需要return顯式返回布爾值,該方法得到一個新數組。 使用Vuex store的modules方式,註意讀取狀態的方式 this.$store.state.cart.items 刷新頁面後state狀態還原,需要用session ...
  • vue 指令與過濾器 內容渲染指令 內容渲染指令是用來輔助開發者渲染 DOM 元素的文本內容。常用的內容渲染指令有3種。 v-text 示例 <div id="app"> <!-- 把 username 對應的值,渲染到第一個 p 標簽中 --> <p v-text="username"></p> ...
  • vue3 正式發佈有兩年多了,之前也做過一些學習和研究。vue3 發佈後給某培訓機構開發了一套vue3課程課件,自己也開源了一套基於vue3的後臺管理系統(因為個人懶的原因,半年後才上傳到gitHub,且到目前為止一直沒有更新過)。 附上網址:https://github.com/gegestst1 ...
  • 情景說明: 之前用 vue 做數據綁定更新時,發現一個莫名奇妙的問題。 我在 vue 實例中聲明瞭一個數組屬性如 books: [],在非同步請求的回調函數中使用 this.books = res.data.data; 進行數據更新,更新步驟後面緊跟著列印了 console.log(this.book ...
  • webpack優化主要有三個方面:1.提高構建速度,2.減少打包體積,3.優化用戶體驗 提高構建速度: 啟用多線程 thread-loader 使用thread-loader插件可以啟用多線程進行構建。 使用緩存 cache-loader 使用cache-loader插件可以對構建進行緩存,加快後續 ...
  • 前言: 昨天咱們已經把貪吃蛇的頁面寫好了,今天咱們來寫 TS 部分 TS 我們要用面向對象的形式去編寫我們的功能,所以我們要以一個功能去定義一個對象 把這個項目分成幾個模塊,也就是幾個對象功能 Food類(食物類): 寫對象的前提,我們要去定義類,用類去創建對象 首先我們直接 class 一個 Fo ...
  • 如果在後端django里配置了django-cors-headers,前端還是報Access to XMLHttpRequest at‘httplocalhost這樣的跨域問題,可以通過以下的方式解決! 通過配置vue.config.js、proxy 實踐解決跨域方法(基於封裝好的axios,非原生 ...
  • 寫在前面的話 大多數標簽在展示文本內容的時候都會預設把文本中的空白和換行符去掉,這的確大大的使得文本的排版更加美觀了,也怎加了區域的利用率,可是就有一些需求是需要原原本本的展示出原汁原味的文本格式。那該如何展示出文本的內在格式呢?無外乎把不該去掉的空格展示出來,把不該合併的換行讓它換行起來。 那麼 ...
一周排行
    -Advertisement-
    Play Games
  • 簡介 本文的初衷是希望幫助那些有其它平臺視覺演算法開發經驗的人能快速轉入Halcon平臺下,通過文中的示例開發者能快速瞭解一個Halcon項目開發的基本步驟,讓開發者能把精力完全集中到演算法的開發上面。 首先,你需要安裝Halcon,HALCON 18.11.0.1的安裝包會放在文章末尾。安裝包分開發和 ...
  • 本文是對Datawhale的動手學數據分析課程的學習總結,記錄了整體的學習過程、答案以及個人感想,代碼較為詳細。 ...
  • JZ7重建二叉樹 描述 給定節點數為 n 的二叉樹的前序遍歷和中序遍歷結果,請重建出該二叉樹並返回它的頭結點。 例如輸入前序遍歷序列{1,2,4,7,3,5,6,8}和中序遍歷序列{4,7,2,1,5,3,8,6} 提示: 1.vin.length == pre.length 2.pre 和 vin ...
  • 我們都知道在Java編程中多線程的同步使用synchronized關鍵字來標識,那麼這個關鍵字在JVM底層到底是如何實現的呢。 我們先來思考一下如果我們自己實現的一個鎖該怎麼做呢: 首先肯定要有個標記記錄對象是否已經上鎖,執行同步代碼之前判斷這個標誌,如果對象已經上鎖線程就阻塞等待鎖的釋放。 其次要 ...
  • 目錄 一.OpenGL 色階 1.Windows OpenGL ES 版本 2.Windows OpenGL 版本 二.OpenGL 色階 GLSL Shader 三.猜你喜歡 零基礎 OpenGL ES 學習路線推薦 : OpenGL ES 學習目錄 >> OpenGL ES 基礎 零基礎 Ope ...
  • 1. 查看Linux伺服器版本信息 # cat /etc/redhat-release CentOS Linux release 7.4.1708 (Core) 2. 禪道開源版安裝包下載 wget http://dl.cnezsoft.com/zentao/9.8.2/ZenTaoPMS.9.8. ...
  • Spring 框架可以為 Java 應用程式開發提供全面的基礎設施支持,它是現在非常流行的 Java 開源框架,對於一個 Java 開發人員來說,熟練掌握 Spring 是必不可少的。 ...
  • 前言 本篇是c++總結的第二篇,關於c++的對象模型,在構造、拷貝虛函數上重點分析,也包含了c++11class的新用法和特性,如有不當,還請指教! c++三大特性 訪問許可權 ​ 在c++中通過public、protected、private三個關鍵字來控製成員變數和成員函數的訪問許可權,它們分別表示 ...
  • 一.小結 1.使用二維數組來存儲表格 2.可以使用以下語法來聲明二維數組變數: 元素類型[ ] [ ]數組變數 3.可以使用以下語法來創建二維數組變數: new 元素類型 [行的個數][列的個數] 4.使用下麵的語法表示二維數組中的每個元素: 數組變數[行下標][列的個數] 5.可使用數組初始化語法 ...
  • typimg是一款為typora編輯器提供圖像自定義上傳服務的工具,該工具將在typora中輸入的網路圖片、本地圖片、剪貼板圖片/截圖上傳到博客園,支持在MacOS、Windiws、Linux三個平臺上運行。 ...