萬盛學電腦網

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

SQL Server JDBC 連線配置標準化 SOP:驅動安裝、伺服器網路、認證模式、Eclipse 專案整合

從零到連線成功的 8 步標準作業程序

整合 SQL Server JDBC 連線常因版本不匹配、網路協定未啟用、認證模式錯誤而失敗。本文提供**可核對清單式 SOP**,確保一次成功。

SOP 8 步驟

Step 1: 確認 JDK 版本並下載對應驅動

  • JDK 8+ → 下載 **mssql-jdbc-12.x.jre11.jar** (或 jre8/jre17)
  • Maven: `com.microsoft.sqlserver:mssql-jdbc:12.4.2.jre11`
  • 官網:

Step 2: 部署驅動 JAR 到運行時類路徑

  • **Maven/Gradle 專案**:自動打包進 `WEB-INF/lib` / Fat JAR,**無需手動操作**
  • **傳統 Web 應用 (Tomcat)**:放入 **`$CATALINA_BASE/webapps/yourApp/WEB-INF/lib/`** (不可放 `$CATALINA_HOME/lib`)
  • **桌面應用/Eclipse 專案**:專案右鍵 → Properties → Java Build Path → Libraries → Add External JARs → 選中 JAR

Step 3: SQL Server 啟用 TCP/IP 並固定端口 1433

  1. 啟動 **SQL Server Configuration Manager (SSCM)** (`SQLServerManager13.msc` 等)
  2. **SQL Server 網路配置 → Protocols for MSSQLSERVER** (或具體實例名)
  3. 右鍵 **TCP/IP → Enable (啟用)**
  4. 雙擊 TCP/IP → **IP Addresses** 頁籤 → 滑到底 **IPAll**:
    • `TCP Dynamic Ports` → **清空 (空白)**
    • `TCP Port` → **1433**
  5. 重啟 **SQL Server (MSSQLSERVER) 服務**

Step 4: 切換混合認證模式並啟用 sa

  1. SSMS 以 Windows 驗證登入
  2. 伺服器右鍵 → **Properties → Security → Server authentication: SQL Server and Windows Authentication mode**
  3. **Security → Logins → sa** → 右鍵 Properties:
    • General: 設定強密碼、確認密碼
    • Status: **Login → Enabled**
  4. **重啟 SQL Server 服務** 使認證模式生效
  5. 用 `sa` + 新密碼 登入驗證

Step 5: 防火牆放行 1433

  • Windows Defender 防火牆 → 進階設定 → 入站規則 → 新增規則 → 連接埠 → TCP → 1433 → 允許連線 → 所有設定檔 → 命名 `SQL Server 1433`
  • 雲伺服器 (AWS/Azure/阿里雲) 同步配置**安全群組/網路 ACL** 入站 1433

Step 6: 編寫標準測試代碼 (複製即跑)

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

        try {
            Class.forName(driver); // JDBC 4.0+ 可省略 (SPI 自動載入)
            try (Connection conn = DriverManager.getConnection(url, user, pwd)) {
                System.out.println("✅ Connection Successful! Catalog: " + conn.getCatalog());
                try (Statement st = conn.createStatement();
                     ResultSet rs = st.executeQuery("SELECT @@VERSION")) {
                    if (rs.next()) System.out.println("Server: " + rs.getString(1));
                }
            }
        } catch (Exception e) {
            System.err.println("❌ Failed: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Step 7: Eclipse 專案導入驅動 JAR (圖文步驟)

  1. 專案右鍵 → **Properties**
  2. 左側 **Java Build Path** → **Libraries** 頁籤
  3. **Add External JARs...** → 選中 `mssql-jdbc-12.4.2.jre11.jar` → **Apply and Close**
  4. 若用 Maven:`pom.xml` 加依賴 → 右鍵專案 → **Maven → Update Project**

Step 8: 驗證與常見失敗對照

現象檢查項目
ClassNotFoundExceptionStep 2 JAR 路徑、Maven 依賴範圍 (非 provided)
No suitable driverStep 6 URL 協議頭 `jdbc:sqlserver://`、驅動類名
Connection refused / timeoutStep 3 TCP/IP 啟用、端口 1433、Step 5 防火牆、服務運行中
Login failed for user 'sa'Step 4 混合模式、sa 啟用、密碼正確、重啟服務
The driver could not establish a secure connectionStep 6 URL 加 `encrypt=true;trustServerCertificate=true` (測試環境)

生產環境加固項

  • 建立專用應用帳號 (最小權限),禁用 `sa` 外網直連
  • 強制 TLS 1.2+:伺服器部署有效憑證,客戶端 `encrypt=true;trustServerCertificate=false`
  • 連線池:HikariCP `maximumPoolSize`、`connectionTimeout`、`leakDetectionThreshold`
  • 監控:`spring-boot-actuator` + Micrometer 暴露 `hikaricp.connections.*` 指標
copyright © 萬盛學電腦網 all rights reserved