Java 連線 Oracle 避坑指南：ORA-01000 遊標洩漏根因與解決

錯誤現象

java.sql.SQLException: ORA-01000: maximum open cursors exceeded

表示單一進程開啟的游標數超過 open_cursors 參數限制（預設 300）。

根本原因：Java 程式碼資源未釋放

• Connection.createStatement()、prepareStatement()、prepareCall() 在資料庫端各對應一個開啟游標。
• 若在迴圈中重複建立 Statement 卻未關閉，游標數線性增長，迅速觸頂。
• ResultSet 未關閉也會持有游標資源。

錯誤程式碼模式

// ❌ 錯誤：迴圈內重複建立 Statement，無 close
for (int i=0; i<1000; i++) {
    Statement stmt = conn.createStatement();
    ResultSet rs = stmt.executeQuery("SELECT ...");
    // 處理 rs
    // 遺漏 rs.close(), stmt.close()
}

正確資源管理模式

JDBC 4.0+ try-with-resources（推薦）

// ✅ 自動關閉 Connection/Statement/ResultSet
try (Connection conn = dataSource.getConnection();
     PreparedStatement ps = conn.prepareStatement(sql)) {
    ps.setInt(1, id);
    try (ResultSet rs = ps.executeQuery()) {
        while (rs.next()) { /* 處理 */ }
    }
} catch (SQLException e) { /* 處理異常 */ }

舊版 finally 區塊寫法

Connection conn = null;
PreparedStatement ps = null;
ResultSet rs = null;
try {
    conn = dataSource.getConnection();
    ps = conn.prepareStatement(sql);
    rs = ps.executeQuery();
    while (rs.next()) { /* 處理 */ }
} finally {
    if (rs != null) try { rs.close(); } catch (SQLException ignore) {}
    if (ps != null) try { ps.close(); } catch (SQLException ignore) {}
    if (conn != null) try { conn.close(); } catch (SQLException ignore) {}
}

關鍵最佳實踐

1. PreparedStatement 重用：SQL 模板固定時，在迴圈外部建立 PreparedStatement，迴圈內僅 setParameter + executeUpdate/executeQuery，結束後一次 close。
2. 批次處理：大量 DML 使用 addBatch() + executeBatch()，大幅減少網路往返與游標開啟次數。
3. 連線池設定：maxPoolSize × open_cursors ＜ 資料庫端 processes 參數，避免連線耗盡。
4. 不要盲目調大 open_cursors：治標不治本，掩蓋程式缺陷；預設 300 足夠多數應用。
5. 日期綁定用 setDate/setTimestamp：避免 TO_DATE 字串拼接導致硬解析與計畫不共享。

常見錯誤清單

排查工具

• 資料庫端：SELECT * FROM v$open_cursor WHERE sid = ... 定位洩漏 Session 的 SQL 文本。
• Java 端：VisualVM / JProfiler 監控連線池狀態、Statement 物件計數。
• 啟用 JDBC 驅動日誌：-Doracle.jdbc.Trace=true 追蹤 Statement 建立/關閉呼叫堆疊。

總結

ORA-01000 幾乎 100% 為應用層資源管理缺失。落實「取得→使用→立即關閉」原則、善用 PreparedStatement 重用與批次 API、導入連線池與 try-with-resources，即可從根源杜絕遊標洩漏，同時提升應用效能與穩定性。

1. 上一篇文章： Oracle PL/SQL 程式設計入門：區塊結構、控制流與核心物件
2. 下一篇文章： 四大主流資料庫深度對比：Oracle、SQL Server、Sybase、DB2

Oracle 資料庫基礎

深入掌握 Oracle 層次查詢：從語法到實戰應用

在關聯式資料庫中，處理樹狀或階層式資料結構時，Oracle

MySQL GROUP BY 實現原理深度解析：鬆散索引掃描、緊湊索引掃描與臨時表回退

背景 GROUP BY 實質包含「排序 + 分組 + 聚合」

Oracle 建立表空間、使用者與授權的標準四步驟腳本

1. 建立使用者表空間（永久） CREATE TABLESP

知識管理系統（KMS）資料庫平台選型指南：關係型與文檔型的抉擇與融合

前言：KMS 的雙重資料挑戰 知識管理系統（KMS）需處理兩