JDBC 連接 SQL Server 看似簡單,實則涉及驅動版本選擇、類載入機制、Tomcat/IDE 類路徑、連線池配置、SQL Server 網路設定、認證模式、防火牆等多環節。本文提供**標準化全流程 SOP**。
com.microsoft.sqlserver
mssql-jdbc
12.4.2.jre11
// Gradle
implementation 'com.microsoft.sqlserver:mssql-jdbc:12.4.2.jre11'
-cp ".;mssql-jdbc-12.4.2.jre11.jar" com.example.JdbcTest
// 或 IDE (IntelliJ/Eclipse) → Module Dependencies → +JARs
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
| 現象 | 根因 | 驗證/修復 |
|---|---|---|
| ClassNotFoundException | JAR 不在類路徑 | Maven 依賴 / WEB-INF/lib / -cp |
| No suitable driver | URL 協議頭錯 / 驅動未註冊 | jdbc:sqlserver://... / DriverManager.getDrivers() 檢查 |
| Connection refused | 端口/防火牆/服務未啟動/TCP/IP 未啟用 | telnet/SSCM/防火牆/錯誤日誌 |
| Login failed | 用戶/密碼/認證模式/鎖定/權限 | SSMS 測試登入、檢查用戶映射 |
| SSL/TLS 錯誤 | encrypt=true 但無有效憑證 | trustServerCertificate=true (測試) / 部署正式憑證 (生產) |