SQL Server JDBC 驅動配置完整步驟：從下載到 Eclipse/IDEA 專案整合測試

版本對應關係

建議：新專案直接用最新 mssql-jdbc-12.4.1.jre11.jar（JDK 11+）或 jre8.jar（JDK 8）。

步驟 1：下載驅動 JAR

• 官方：GitHub Releases 或 Microsoft Docs
• Maven Central：com.microsoft.sqlserver:mssql-jdbc:12.4.1.jre11

步驟 2：加入專案 Classpath

Eclipse

1. 專案右鍵 → Build Path → Configure Build Path
2. Libraries 分頁 → Add External JARs → 選取下載的 JAR
3. 或建立專案 lib/ 目錄 → 放入 JAR → Add JARs 選取專案內 JAR（利於版控）

IntelliJ IDEA

1. File → Project Structure (Ctrl+Alt+Shift+S)
2. Modules → Dependencies → + → JARs or directories → 選取 JAR
3. 或直接用 Maven/Gradle 依賴管理（推薦）

步驟 3：SQL Server 啟用 TCP/IP（必要）

1. 開啟 SQL Server Configuration Manager
2. SQL Server Network Configuration → Protocols for MSSQLSERVER（或具名實例）
3. 右鍵 TCP/IP → Enable
4. 雙擊 TCP/IP → IP Addresses → IPAll → TCP Port = 1433
5. 重啟 SQL Server 服務（SQL Server (MSSQLSERVER)）

步驟 4：設定混合驗證模式並啟用 sa

1. SSMS 以 Windows 驗證登入
2. 伺服器右鍵 → Properties → Security → SQL Server and Windows Authentication mode
3. 重啟服務
4. 展開 Security → Logins → sa 右鍵 → Properties
5. General：設定密碼 → Status：Login Enabled → OK
6. 重啟服務生效

步驟 5：測試連線代碼

package com.example.test;

import java.sql.*;

public class JdbcConnectionTest {
    public static void main(String[] args) {
        String driver = "com.microsoft.sqlserver.jdbc.SQLServerDriver";
        String url = "jdbc:sqlserver://localhost:1433;databaseName=SampleDB;encrypt=true;trustServerCertificate=true";
        String user = "sa";
        String pwd = "YourStrongPassword123";

        try {
            Class.forName(driver); // JDBC 4.0+ 可省略
            try (Connection conn = DriverManager.getConnection(url, user, pwd)) {
                System.out.println("✅ Connection Successful!");
                System.out.println("Catalog: " + conn.getCatalog());
                System.out.println("Meta: " + conn.getMetaData().getDatabaseProductVersion());
            }
        } catch (Exception e) {
            System.err.println("❌ Failed: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

常見坑點總結

• ❌ 同時放 sqljdbc.jar 和 sqljdbc4.jar → 類衝突，只保留一個對應 JDK 版本的 JAR。
• ❌ 驅動類名寫舊版 com.microsoft.jdbc.sqlserver.SQLServerDriver → 4.0+ 統一 com.microsoft.sqlserver.jdbc.SQLServerDriver。
• ❌ 防火牆攔截 1433 → Windows 防火牆新增入站規則允許 1433 TCP。
• ❌ 命名實例連線 → URL 加 instanceName=SQLEXPRESS 或指定實例埠（動態埠需 SQL Browser 服務）。
• ❌ TLS 握手失敗 → 開發環境加 trustServerCertificate=true，生產環境配置有效憑證。

Maven/Gradle 依賴（推薦）

<!-- Maven -->
<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>12.4.1.jre11</version>
</dependency>

// Gradle
implementation 'com.microsoft.sqlserver:mssql-jdbc:12.4.1.jre11'