MyBatis-Plus 非 Spring 環境使用時 GenericTypeResolver 缺失問題總結

問題描述

在非 Spring 環境中使用 MyBatis-Plus 3.4.3.1 及以上版本時，啟動程序會拋出以下錯誤：

Exception in thread "main" java.lang.NoClassDefFoundError: org/springframework/core/GenericTypeResolver
at com.baomidou.mybatisplus.core.toolkit.reflect.SpringReflectionHelper.resolveTypeArguments(...)

該錯誤是由于 MyBatis-Plus 的部分工具類依賴 Spring 核心庫中的 GenericTypeResolver 類，但項目未引入 Spring 相關依賴導致的。

問題原因

1. 依賴變化：
   MyBatis-Plus 從 3.4.3.1 版本開始，其內部反射工具類（如 SpringReflectionHelper、ReflectionKit）直接依賴 Spring 的 org.springframework.core.GenericTypeResolver，用于處理類型解析邏輯。

   • 即使項目不使用 Spring 框架，只要使用 MyBatis-Plus 3.4.3.1 及以上版本，就必須引入 Spring 核心依賴。

2. 歷史版本差異：

   • 3.4.3 及之前版本：不強制依賴 Spring 核心庫，但可能存在其他問題（如 Lambda 表達式支持不完整）。
   • 3.4.3.1 及之后版本：為修復部分功能（如 Lambda 語法兼容性），引入了對 Spring 核心庫的依賴。

解決方案

在項目中添加 Spring 核心庫依賴（僅需輕量級的 spring-core，無需引入完整 Spring 框架）：

Maven 依賴

<dependency>  <groupId>org.springframework</groupId>  <artifactId>spring-core</artifactId>  <version>5.3.29</version> <!-- Java8最新穩定版，根據項目需求調整 -->  
</dependency>  

Gradle 依賴

implementation 'org.springframework:spring-core:5.3.29'  

版本選擇建議

版本范圍	依賴要求	注意事項
3.4.3 及之前	無需 Spring 核心依賴	可能存在 Lambda 表達式兼容性問題（如條件構造器的 Lambda 語法異常）。
3.4.3.1 及以上	必須添加 spring-core 依賴	修復了 Lambda 表達式等功能，但引入 Spring 依賴；適合需要穩定 Lambda 支持的場景。

總結

1. 非 Spring 環境限制：
   MyBatis-Plus 3.4.3.1 及以上版本在非 Spring 項目中無法完全脫離 Spring 核心庫，必須添加 spring-core 依賴以解決類型解析工具的類缺失問題。

2. 依賴最小化：
   只需引入 spring-core 單包（約 2MB），無需其他 Spring 模塊，對項目輕量化影響極低。

3. 版本兼容性：

   • 若項目未使用 Lambda 復雜語法，可嘗試 3.4.3 版本（避免依賴 Spring），但需注意潛在兼容性問題。
   • 推薦使用 3.5.x 及以上版本，并按上述方案添加依賴，以獲得完整功能和穩定性。

參考資料

• MyBatis-Plus GitHub Issue：#4223 3.4.3.1及其以上版本 依賴于Spring-core，無法脫離Spring使用
• Spring Core 官方文檔：Spring Core Module

通過添加 spring-core 依賴，可快速解決 GenericTypeResolver 缺失問題，確保 MyBatis-Plus 在非 Spring 環境中正常運行。