Java JDBC 連接 SQL Server 2008 常見錯誤與解決：驅動類別名稱與連接字串

錯誤現象

java.sql.SQLException: No suitable driver found for jdbc:microsoft:sqlserver://127.0.0.1:1433;DatabaseName=QQ

根本原因

JDBC 驅動版本不匹配：

• 舊版驅動 (sqljdbc.jar 1.0/1.1)：類別 com.microsoft.jdbc.sqlserver.SQLServerDriver，URL 前綴 jdbc:microsoft:sqlserver:
• 新版驅動 (sqljdbc4.jar 2.0+，SQL Server 2005+ 專用)：類別 com.microsoft.sqlserver.jdbc.SQLServerDriver，URL 前綴 jdbc:sqlserver: (無 microsoft)

正確程式碼範例

package com.qq.client.db;

import java.sql.Connection;
import java.sql.DriverManager;

public class ConnDB {
    private Connection conn = null;

    public Connection getConn() {
        try {
            // 1. 載入新版驅動類別 (SQL Server 2005/2008/2012/2014/2016/2019)
            Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
            
            // 2. 正確連接字串 (無 microsoft)
            conn = DriverManager.getConnection(
                "jdbc:sqlserver://127.0.0.1:1433;DatabaseName=QQ", 
                "sa", "sa");
        } catch (Exception e) {
            e.printStackTrace();
        }
        return conn;
    }
}

關鍵差異對照

驅動下載與相依

• 官方下載：Microsoft JDBC Driver for SQL Server (GitHub 或 Microsoft Download Center)
• Maven 依賴：

  <dependency>
      <groupId>com.microsoft.sqlserver</groupId>
      <artifactId>mssql-jdbc</artifactId>
      <version>12.2.0.jre11</version>
  </dependency>

• 將 jar 放入專案 classpath 或 WEB-INF/lib

進階連接字串參數

jdbc:sqlserver://host:1433;DatabaseName=MyDB;Encrypt=true;TrustServerCertificate=false;loginTimeout=30;