Hibernate 查詢報 AbstractMethodError: NullString.nullSafeGet 的驅動包版本衝突排查

錯誤堆疊關鍵

java.lang.AbstractMethodError: com.dev.swms.server.model.abstractEntity.NullString.nullSafeGet(...)
at org.hibernate.type.CustomType.nullSafeGet(CustomType.java:124)
at org.hibernate.persister.entity.AbstractEntityPersister.hydrate(...)

根因分析

AbstractMethodError 表明運行時類的方法簽名與編譯時不一致。此處為 Hibernate 自定義類型 NullString 的 nullSafeGet 方法簽名與當前 Hibernate 版本期望的不匹配。

常見觸發場景

1. Hibernate 版本升級（如 4.x → 5.x），UserType/CompositeUserType 接口方法簽名變更，舊代碼未同步修改。
2. 數據庫驅動版本不匹配：MySQL Connector/J 版本與 Hibernate 方言不兼容（如 8.0 驅動配 5.x 方言）。
3. 多模塊依賴衝突：不同模塊引入不同版本的 hibernate-core，類加載器加載了舊版本類。

排查步驟

1. 執行 mvn dependency:tree | grep hibernate 檢查版本統一性。
2. 確認 hibernate-core、hibernate-entitymanager、mysql-connector-java 版本兼容（參考官方兼容性矩陣）。
3. 檢查自定義類型 NullString 實現是否符合當前 Hibernate 版本接口要求（參考官方遷移指南）。
4. 清理 IDE 緩存 / 重新打包：mvn clean install -U。

快速修復嘗試

• 統一 Hibernate 版本為 5.4.x Final（長期支持）。
• MySQL 驅動升級至 8.0.28+，方言類用 org.hibernate.dialect.MySQL8Dialect。
• 若自定義類型非必要，考慮移除改用標準類型 + @ColumnTransformer。