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 是開源、成熟、全面實現 JDBC 規範的 SQL Server/Sybase 驅動,完美兼容 Hibernate。
<dependency>
<groupId>net.sourceforge.jtds</groupId>
<artifactId>jtds</artifactId>
1.3.1
</dependency>
JDK 版本對應:
UnsupportedClassVersionError: major.minor version 51.0,說明驅動編譯版本過高,降級驅動或升級 JDK。<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 使用 : 分隔端口,而非微軟驅動的 ;。
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 歷史項目的穩妥選擇。