MyEclipse 連接 SQL Server 2012 報 ClassNotFoundException：JDBC 驅動類名拼寫錯誤排查

MyEclipse 連接 SQL Server 2012 報 ClassNotFoundException：JDBC 驅動類名拼寫錯誤排查

錯誤信息：java.lang.ClassNotFoundException: com.microsoft.sqlserver.jdbc.SQLServerDriver（或類似），通常是驅動類全限定名拼寫錯誤或 JAR 包未加入構建路徑。

正確驅動類名

// Microsoft 官方 JDBC Driver 6.0+ (推薦)
com.microsoft.sqlserver.jdbc.SQLServerDriver

// 舊版 jTDS (不再維護)
net.sourceforge.jtds.jdbc.Driver

常見拼寫錯誤

• com.microsoft.sqlserver.jdbc.SQLServerDriver → 少寫 r：SQLServeDriver
• com.microsoft.sqlserver.jdbc.SQLServerDriver → 大小寫錯誤：sqlserverdriver
• 包名寫錯：com.microsoft.jdbc.sqlserver.SQLServerDriver (舊版 2000 驅動)

完整修復步驟

1. 下載 Microsoft JDBC Driver for SQL Server（.jar 文件，如 mssql-jdbc-12.2.0.jre11.jar）。
2. MyEclipse 中：右鍵專案 → Build Path → Configure Build Path → Libraries → Add External JARs 選中該 jar。
3. 在數據庫連接配置界面（或 jdbc.properties）設置：
   driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
url=jdbc:sqlserver://localhost:1433;databaseName=YourDB
4. 確保 SQL Server 2012 開啟 TCP/IP 協議（SQL Server Configuration Manager），防火牆放行 1433 端口。

驗證

在 MyEclipse 「Database Explorer」中創建新連接，測試連接成功即配置正確。

拼寫準確、JAR 包到位、網絡通暢，三者缺一不可。