快捷導(dǎo)航

SpringBoot3.x與MyBatis-Plus兼容問(wèn)題小結(jié)

更新時(shí)間：2026年04月02日 10:20:20 作者：博傅

SpringBoot3.2+版本使用MyBatis-Plus時(shí),出現(xiàn)等類型不匹配/依賴沖突報(bào)錯(cuò),下面就來(lái)詳細(xì)的介紹一下SpringBoot3.x與MyBatis-Plus兼容問(wèn)題小結(jié),感興趣的可以了解一下

問(wèn)題場(chǎng)景

Spring Boot 3.2+ 版本使用 MyBatis-Plus 時(shí)，出現(xiàn) Invalid value type 等類型不匹配/依賴沖突報(bào)錯(cuò)，核心原因是 MyBatis-Plus 舊版本與 Spring Boot 3.x 不兼容。

解決方案（兩種方案二選一）

方案一：直接使用 Spring Boot 3 專屬 Starter（推薦）

直接替換為 MyBatis-Plus 官方適配 Spring Boot 3 的依賴包，無(wú)需額外排除依賴。

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
    <version>3.5.5</version> <!-- 或更新的兼容版本 -->
</dependency>

? 優(yōu)點(diǎn)：配置簡(jiǎn)單、官方適配、無(wú)額外沖突風(fēng)險(xiǎn)

? 適用：新項(xiàng)目或可直接升級(jí) MyBatis-Plus 版本的場(chǎng)景

方案二：手動(dòng)排除舊依賴 + 引入兼容版本

若暫時(shí)無(wú)法升級(jí) MyBatis-Plus 版本，可手動(dòng)排除舊版 mybatis-spring，并引入兼容 Spring Boot 3 的版本。

<!-- 原有 mybatis-plus-boot-starter -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.4.1</version>
    <!-- 排除舊版 mybatis-spring -->
    <exclusions>
        <exclusion>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- 引入兼容 Spring Boot 3 的 mybatis-spring 版本 -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>3.0.3</version> <!-- 或更高兼容版本 -->
</dependency>

? 優(yōu)點(diǎn)：無(wú)需升級(jí) MyBatis-Plus 主版本，僅替換底層依賴

? 適用：舊項(xiàng)目升級(jí) Spring Boot 3 但 MyBatis-Plus 版本不便變動(dòng)的場(chǎng)景

操作步驟

修改 pom.xml：按上述方案替換/調(diào)整 MyBatis-Plus 依賴配置

清理并重新構(gòu)建：

mvn clean compile -U

（-U 強(qiáng)制更新依賴，避免本地緩存問(wèn)題）

重啟項(xiàng)目：?jiǎn)?dòng) Spring Boot 應(yīng)用，驗(yàn)證報(bào)錯(cuò)是否消失

IDEA 同步：在 IDEA 中點(diǎn)擊「Reload All Maven Projects」刷新依賴

注意事項(xiàng)

版本對(duì)齊：確保 mybatis-plus-spring-boot3-starter 或 mybatis-spring 版本與當(dāng)前 Spring Boot 3.x 版本兼容
避免重復(fù)依賴：不要同時(shí)引入 mybatis-plus-boot-starter 和 mybatis-plus-spring-boot3-starter
緩存清理：若依賴下載失敗，刪除本地 Maven 倉(cāng)庫(kù)中對(duì)應(yīng)包目錄后重試
測(cè)試驗(yàn)證：修改后需完整測(cè)試數(shù)據(jù)庫(kù)操作，確保 MyBatis-Plus 功能正常

核心結(jié)論

Spring Boot 3.x 必須使用 適配 Spring Boot 3 的 MyBatis-Plus 依賴：

優(yōu)先選擇 mybatis-plus-spring-boot3-starter（官方原生適配）
無(wú)法升級(jí)時(shí)，手動(dòng)排除舊版 mybatis-spring 并引入 3.0.3+ 兼容版本

到此這篇關(guān)于SpringBoot3.x與MyBatis-Plus兼容問(wèn)題小結(jié)的文章就介紹到這了,更多相關(guān)SpringBoot3.x MyBatis-Plus兼容內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: