萬盛學電腦網

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

SQL Server JDBC 驅動配置全流程:從下載、Tomcat/IDE 整合到連線池生產部署

零坑配置 Microsoft JDBC Driver for SQL Server

JDBC 連接 SQL Server 看似簡單,實則涉及驅動版本選擇、類載入機制、Tomcat/IDE 類路徑、連線池配置、SQL Server 網路設定、認證模式、防火牆等多環節。本文提供**標準化全流程 SOP**。

1. 驅動下載與版本選擇

  • 官網:
  • **推薦**:最新 **12.x** 版 (支援 SQL Server 2008~2022, Java 8/11/17/21)
  • Maven/Gradle 坐標 (首選,自動傳遞依賴):
    
    
      com.microsoft.sqlserver
      mssql-jdbc
      12.4.2.jre11 
    
    
    // Gradle
    implementation 'com.microsoft.sqlserver:mssql-jdbc:12.4.2.jre11'
  • 手動下載:解壓獲取 `mssql-jdbc-.jar`

2. SQL Server 伺服器端網路配置 (必做)

  1. 開啟 **SQL Server Configuration Manager (SSCM)**
  2. **SQL Server 網路配置 → MSSQLSERVER 協定 (或具體實例名)**
  3. 右鍵 **TCP/IP → 啟用**
  4. 雙擊 TCP/IP → **IP 位址** 頁籤 → **IPAll** 區段:
    • `TCP Dynamic Ports` → **清空**
    • `TCP Port` → **1433** (或自定義固定端口)
  5. **SQL Native Client 設定 → 用戶端協定** → 同樣啟用 TCP/IP
  6. **SQL Server 服務** → 右鍵重新啟動

3. 認證模式與 sa 啟用

  1. SSMS 以 Windows 驗證登入
  2. 安全性 → 登入名 → `sa` → 右鍵屬性 → **一般** 設強密碼 → **狀態** → **啟用**
  3. 伺服器屬性 → **安全性** → **SQL Server 和 Windows 驗證模式** → 確定 → **重啟服務**

4. 應用端配置 (三種場景)

A. 純 Java / Main 方法

-cp ".;mssql-jdbc-12.4.2.jre11.jar" com.example.JdbcTest
// 或 IDE (IntelliJ/Eclipse) → Module Dependencies → +JARs

B. Tomcat / Jetty / 獨立 Servlet 容器

  • **不要** 放入 `%CATALINA_HOME%/lib` (類載入隔離問題)
  • **必須** 放入 **WebApp 的 `WEB-INF/lib`** (Maven/Gradle 自動打包)
  • JNDI DataSource 配置 (`context.xml`):
     

C. Spring Boot / Spring DataSource 自動配置

spring:
  datasource:
    url: jdbc:sqlserver://localhost:1433;databaseName=myDB;encrypt=true;trustServerCertificate=true;
    username: app_user
    password: StrongPwd
    driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
    hikari:
      maximum-pool-size: 20
      minimum-idle: 5
      connection-timeout: 30000
      validation-timeout: 5000
      leak-detection-threshold: 60000

5. Windows 整合驗證 (Kerberos/NTLM) 進階

  • 需 `mssql-jdbc_auth--.dll` 放入 `java.library.path` (或 `PATH`)
  • URL 加 `integratedSecurity=true;authenticationScheme=JavaKerberos` (或 `NTLM`)
  • Kerberos 需 SPN 設定 (`setspn -A MSSQLSvc/host:1433 domain\service_account`)、`krb5.conf`、`jaas.conf`
  • **一般建議**:避免整合驗證,改用 SQL 驗證 + 強密碼 + 定期輪換,架構更簡單

6. 常見坑與驗證清單

copyright © 萬盛學電腦網 all rights reserved
現象根因驗證/修復
ClassNotFoundExceptionJAR 不在類路徑Maven 依賴 / WEB-INF/lib / -cp
No suitable driverURL 協議頭錯 / 驅動未註冊jdbc:sqlserver://... / DriverManager.getDrivers() 檢查
Connection refused端口/防火牆/服務未啟動/TCP/IP 未啟用telnet/SSCM/防火牆/錯誤日誌
Login failed用戶/密碼/認證模式/鎖定/權限SSMS 測試登入、檢查用戶映射
SSL/TLS 錯誤encrypt=true 但無有效憑證trustServerCertificate=true (測試) / 部署正式憑證 (生產)