萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MS SQL 資料庫

Hibernate 連接 SQL Server 報 AbstractMethodError:換用 jTDS 驅動完美解決

現象

Hibernate 專案切換至 SQL Server 後,啟動報錯:

java.lang.AbstractMethodError: com.microsoft.jdbc.base.BaseDatabaseMetaData.getJDBCMajorVersion()I
// 或
java.lang.AbstractMethodError: com.microsoft.jdbc.base.BaseDatabaseMetaData.supportsGetGeneratedKeys()Z

現象:SQL Server 客戶端、MyEclipse 反向工程均正常,唯獨 Hibernate 運行時失敗。

根因

微軟官方 JDBC 驅動(com.microsoft.jdbc.* 或早期 sqljdbc.jar)實現不完整,缺少 Hibernate 要求的 DatabaseMetaData 介面新方法(JDBC 3.0/4.0 規範),導致抽象方法調用失敗。純 JDBC 代碼不調用這些元數據方法,故不報錯。

解決方案:改用 jTDS 驅動

jTDS 是開源、成熟、全面實現 JDBC 規範的 SQL Server/Sybase 驅動,完美兼容 Hibernate。

1. Maven 依賴

<dependency>
    <groupId>net.sourceforge.jtds</groupId>
    <artifactId>jtds</artifactId>
    1.3.1  
</dependency>

JDK 版本對應:

  • JDK 6/7 → jtds 1.2.x 或 1.3.1
  • JDK 8+ → jtds 1.3.1+
  • 若報 UnsupportedClassVersionError: major.minor version 51.0,說明驅動編譯版本過高,降級驅動或升級 JDK。

2. Hibernate 配置

<property name="connection.driver_class">net.sourceforge.jtds.jdbc.Driver</property>
<property name="connection.url">jdbc:jtds:sqlserver://<IP>:<Port>;DatabaseName=<DBName></property>
<property name="connection.username">sa</property>
<property name="connection.password">password</property>
<property name="dialect">org.hibernate.dialect.SQLServerDialect</property>  

注意:jTDS URL 使用 : 分隔端口,而非微軟驅動的 ;。

3. 連接池配置(如 HikariCP)

dataSourceClassName=net.sourceforge.jtds.jdbcx.JtdsDataSource
dataSource.serverName=localhost
dataSource.portNumber=1433
dataSource.databaseName=MyDB
dataSource.user=sa
dataSource.password=pass

驗證

重啟應用,錯誤消失,Schema 導出、實體映射、CRUD 操作均正常。

補充:微軟官方驅動現狀

微軟現推薦 mssql-jdbc (v6.0+),已大幅改進 JDBC 合規性,若堅持用官方驅動請升級至最新版並設置 sendStringParametersAsUnicode=false 等參數。但 jTDS 仍是 Hibernate 歷史項目的穩妥選擇。

copyright © 萬盛學電腦網 all rights reserved