您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 程式設計入門

Eclipse 配置 Oracle JDBC 驅動完整圖文教程

編輯：Java 程式設計入門

核心步驟四部曲

第一步：定位驅動 JAR

Oracle 安裝目錄下：[ORACLE_HOME]\jdbc\lib\

JDK 版本	驅動文件	說明
JDK 1.1.x	classes111.zip + nls_charset11.zip	極舊，忽略
JDK 1.2/1.3	classes12.zip + nls_charset12.zip	舊版
JDK 1.4/1.5/1.6	ojdbc14.jar + nls_charset12.zip	常見
JDK 1.6+ (JDBC 4.0)	ojdbc6.jar / ojdbc7.jar / ojdbc8.jar	推薦，自動註冊驅動
JDK 11+	ojdbc10.jar / ojdbc11.jar	模組化版本

原則：驅動版本 ≥ JDK 版本，且匹配資料庫版本。現代項目直接用 Maven 引入 com.oracle.database.jdbc:ojdbc8 或 ojdbc11 最省事。

第二步：系統環境變量 (可選，IDE 內配置通常足夠)


# Windows 示例 (假設 Oracle 安裝在 E:\oracle\ora92)
CLASSPATH=.;E:\oracle\ora92\jdbc\lib\ojdbc14.jar;E:\oracle\ora92\jdbc\lib\nls_charset12.jar
PATH=%PATH%;E:\oracle\ora92\bin

注意：CLASSPATH 以 . 開頭表示當前目錄。

第三步：Eclipse 全局用戶庫配置 (一次配置，多專案復用)

菜單 Window → Preferences
左側樹 Java → Build Path → User Libraries
右側 New... 輸入庫名：Oracle JDBC

Add External JARs...

ojdbc8.jar

nls_charset12.jar

Apply and Close

第四步：專案引用用戶庫

Build Path → Configure Build Path

Libraries

Add Library...

User Library

Next

Oracle JDBC

Finish

驗證測試代碼


public class OracleJdbcTest {
    public static void main(String[] args) {
        String url = "jdbc:oracle:thin:@localhost:1521:ORCL"; // SID 模式
        // String url = "jdbc:oracle:thin:@//localhost:1521/pdborcl"; // 服務名模式 (12c+)
        String user = "scott";
        String pwd = "tiger";
        
        try (Connection conn = DriverManager.getConnection(url, user, pwd)) {
            System.out.println("連接成功！版本: " + conn.getMetaData().getDatabaseProductVersion());
            try (Statement st = conn.createStatement();
                 ResultSet rs = st.executeQuery("SELECT SYSDATE FROM DUAL")) {
                if (rs.next()) System.out.println("資料庫時間: " + rs.getTimestamp(1));
            }
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

常見報錯與解決

錯誤	原因	解決
ClassNotFoundException: oracle.jdbc.driver.OracleDriver	驅動 JAR 未加入 Build Path	檢查步驟 3-4，或 Maven 依賴
ORA-12505 / Listener does not know SID	SID/服務名錯誤	用 `lsnrctl status` 確認實際 SID/服務名
ORA-28040: No matching authentication protocol	JDK 8 + Oracle 12c+ 加密協議不匹配	升級驅動到 ojdbc8/ojdbc11，或配置 `sqlnet.ora` 允許弱加密
java.sql.SQLRecoverableException: IO Error: The Network Adapter could not establish the connection	IP/端口/防火牆/服務未啟動	telnet IP 1521 測通，檢查 listener.ora、防火牆、實例狀態

現代化建議：Maven/Gradle 依賴管理



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


implementation 'com.oracle.database.jdbc:ojdbc8:21.9.0.0'

無需手動下載 JAR、配置用戶庫，專案攜帶依賴，團隊協作零配置。