從零到連線成功的 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
- 啟動 **SQL Server Configuration Manager (SSCM)** (`SQLServerManager13.msc` 等)
- **SQL Server 網路配置 → Protocols for MSSQLSERVER** (或具體實例名)
- 右鍵 **TCP/IP → Enable (啟用)**
- 雙擊 TCP/IP → **IP Addresses** 頁籤 → 滑到底 **IPAll**:
- `TCP Dynamic Ports` → **清空 (空白)**
- `TCP Port` → **1433**
- 重啟 **SQL Server (MSSQLSERVER) 服務**
Step 4: 切換混合認證模式並啟用 sa
- SSMS 以 Windows 驗證登入
- 伺服器右鍵 → **Properties → Security → Server authentication: SQL Server and Windows Authentication mode**
- **Security → Logins → sa** → 右鍵 Properties:
- General: 設定強密碼、確認密碼
- Status: **Login → Enabled**
- **重啟 SQL Server 服務** 使認證模式生效
- 用 `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 (圖文步驟)
- 專案右鍵 → **Properties**
- 左側 **Java Build Path** → **Libraries** 頁籤
- **Add External JARs...** → 選中 `mssql-jdbc-12.4.2.jre11.jar` → **Apply and Close**
- 若用 Maven:`pom.xml` 加依賴 → 右鍵專案 → **Maven → Update Project**
Step 8: 驗證與常見失敗對照
| 現象 | 檢查項目 |
| ClassNotFoundException | Step 2 JAR 路徑、Maven 依賴範圍 (非 provided) |
| No suitable driver | Step 6 URL 協議頭 `jdbc:sqlserver://`、驅動類名 |
| Connection refused / timeout | Step 3 TCP/IP 啟用、端口 1433、Step 5 防火牆、服務運行中 |
| Login failed for user 'sa' | Step 4 混合模式、sa 啟用、密碼正確、重啟服務 |
| The driver could not establish a secure connection | Step 6 URL 加 `encrypt=true;trustServerCertificate=true` (測試環境) |
生產環境加固項
- 建立專用應用帳號 (最小權限),禁用 `sa` 外網直連
- 強制 TLS 1.2+:伺服器部署有效憑證,客戶端 `encrypt=true;trustServerCertificate=false`
- 連線池:HikariCP `maximumPoolSize`、`connectionTimeout`、`leakDetectionThreshold`
- 監控:`spring-boot-actuator` + Micrometer 暴露 `hikaricp.connections.*` 指標