萬盛學電腦網

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

JSP 連接 SQL Server 2008 失敗三大經典錯誤與精準修復方案

ClassNotFound、No suitable driver、登入失敗——逐個擊破

JSP/JDBC 連接 SQL Server 2008 常見三大報錯,本文給出**精確原因定位**與**一鍵修復代碼**,附驅動版本對應表。

錯誤一:ClassNotFoundException: com.microsoft.jdbc.sqlserver.SQLServerDriver

原因:使用了 **舊版 JDBC 1.2/2.0 驅動類名** (sqljdbc.jar),SQL Server 2005+ 需新驅動。

修復:

// ❌ 舊錯誤
Class.forName("com.microsoft.jdbc.sqlserver.SQLServerDriver");

// ✅ 正確 (JDBC 3.0+ / sqljdbc4.jar)
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");

**驅動下載**:Microsoft 官網搜 "Microsoft JDBC Driver for SQL Server",下載 **sqljdbc_4.2/6.0/10.0+** 版 (含 `mssql-jdbc-.jar`)。

錯誤二:SQLException: No suitable driver found for jdbc:microsoft:sqlserver://...

原因:JDBC URL 協議頭錯誤,舊驅動用 `jdbc:microsoft:sqlserver:`,新驅動用 `jdbc:sqlserver:`。

修復:

// ❌ 舊 URL
String url = "jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=test2";

// ✅ 新 URL (標準格式)
String url = "jdbc:sqlserver://localhost:1433;DatabaseName=test2;encrypt=true;trustServerCertificate=true;";

**完整 URL 參數**:`serverName`、`portNumber`、`databaseName`、`user`、`password`、`encrypt`、`trustServerCertificate`、`integratedSecurity`、`authenticationScheme` (Kerberos/NTLM)。

錯誤三:SQLServerException: 無法打開登錄所請求的數據庫 "test2"。登錄失敗。

多重原因排查清單:

  1. 端口不匹配:SQL Server 預設 1433,但 Express/命名實例常為動態端口。
    **定位**:SSCM → SQL Server 網路配置 → 協定 → TCP/IP → IPAll → **TCP Port 固定為 1433** (清空 TCP Dynamic Ports) → 重啟服務。
    **驗證**:`telnet localhost 1433` 或 `netstat -an | findstr 1433`
  2. 用戶權限不足:`sa` 帳號被鎖定/禁用、密碼錯誤、未授權目標資料庫。
    **修復**:SSMS → 安全性 → 登入名 → sa → 狀態 → **啟用**;用戶映射 → 勾選目標 DB → 角色 `db_owner`/`db_datareader/writer`
  3. 認證模式:實例設為「Windows 驗證模式」而代碼用 SQL 驗證。
    **修復**:SSMS → 伺服器屬性 → 安全性 → **SQL Server 和 Windows 驗證模式** → 重啟服務
  4. 防火牆:Windows 防火牆/雲安全組阻擋 1433。添加入站規則允許 TCP 1433。
  5. 加密/憑證:JDBC 6.0+ 預設 `encrypt=true`。若伺服器無有效憑證,需 `trustServerCertificate=true` (僅開發/測試) 或部署正式憑證。

完整可運行測試類

import java.sql.*;
public class JdbcTest {
    public static void main(String[] args) {
        String url = "jdbc:sqlserver://localhost:1433;DatabaseName=test2;encrypt=true;trustServerCertificate=true;";
        String user = "sa";
        String pass = "YourStrongPassword";
        try {
            Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
            try (Connection conn = DriverManager.getConnection(url, user, pass)) {
                System.out.println("✅ 連線成功! Catalog: " + conn.getCatalog());
                try (Statement st = conn.createStatement();
                     ResultSet rs = st.executeQuery("SELECT @@VERSION")) {
                    if (rs.next()) System.out.println("Version: " + rs.getString(1));
                }
            }
        } catch (Exception e) {
            System.err.println("❌ 連線失敗: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

驅動版本對應表 (關鍵)

JDBC 驅動版本JAR 檔名支援 SQL Server最低 JRE類名
1.2 / 2.0sqljdbc.jar2000/20051.4/1.5com.microsoft.jdbc.sqlserver.SQLServerDriver
3.0 / 4.0 / 4.1 / 4.2sqljdbc4.jar / sqljdbc41.jar / sqljdbc42.jar2005~20141.6 / 1.7 / 1.8com.microsoft.sqlserver.jdbc.SQLServerDriver
6.0 / 6.1 / 6.2 / 6.4mssql-jdbc-6.x.jre8.jar2008~20171.8com.microsoft.sqlserver.jdbc.SQLServerDriver
7.0 / 7.2 / 7.4mssql-jdbc-7.x.jre8/11.jar2008~20191.8 / 11com.microsoft.sqlserver.jdbc.SQLServerDriver
8.0 / 9.0 / 10.0 / 11.0 / 12.0mssql-jdbc-.jre8/11/17.jar2008~20221.8 / 11 / 17com.microsoft.sqlserver.jdbc.SQLServerDriver

**建議**:直接用最新 **12.x** 版 (Maven: `com.microsoft.sqlserver:mssql-jdbc:12.4.2.jre11`),向下相容所有支援版本。

copyright © 萬盛學電腦網 all rights reserved