JDBC 連接 Oracle 數據庫 URL 格式錯誤排查與正確寫法

常見錯誤現象

運行 JDBC 連接 Oracle 時拋出：

java.sql.SQLException: No suitable driver found for jdbc：oracle：thin：@127.0.0.1:1521：orcl；

根因分析

URL 字符串包含全角/中文標點符號，導致驅動程序無法識別協議格式。具體表現為：

• 冒號 : 被輸入為全角 ：
• 分號 ; 被輸入為全角 ；
• 或點號 . 被誤用為分隔符

正確 URL 格式

// 標準 Thin 驅動格式
jdbc:oracle:thin:@host:port:SID

// 具體示例
jdbc:oracle:thin:@127.0.0.1:1521:orcl

// 服務名模式（Oracle 12c+ PDB）
jdbc:oracle:thin:@//host:port/service_name
jdbc:oracle:thin:@//127.0.0.1:1521/pdborcl

完整連接代碼示例

String url = "jdbc:oracle:thin:@127.0.0.1:1521:orcl";
String user = "scott";
String password = "tiger";

try (Connection conn = DriverManager.getConnection(url, user, password)) {
    System.out.println("連接成功：" + conn.getMetaData().getURL());
    // 業務邏輯...
} catch (SQLException e) {
    e.printStackTrace();
}

驅動依賴（Maven）

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>21.9.0.0</version>
</dependency>

避坑檢查清單

1. 輸入法切換至英文半角模式編寫 URL
2. 檢查冒號、分號、@ 符號均為 ASCII 字符
3. 確認 Oracle 服務已啟動、監聽端口正確（默認 1521）
4. 驅動 JAR 包已加入 classpath（Maven 依賴或手動導入）
5. SID 與 Service Name 區分：老版本用 SID，新版 CDB/PDB 架構推薦 Service Name

這類低級錯誤極易浪費調試時間，建議在 IDE 中設置「檢查非 ASCII 字符」提示，或直接從官方文檔複製標準 URL 模板修改。