Oracle 常見錯誤排查：ORA-01000 最大開啟游標超過 完整解決方案

錯誤現象

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

應用拋出此異常，表示資料庫會話開啟的游標數超過參數 open_cursors 限制（預設 300）。

四步排查法

Step 1：確認目前參數值

SQL> SHOW PARAMETER open_cursors;
NAME                 TYPE    VALUE
-------------------- ------- -----
open_cursors         integer 300

Step 2：找出佔用游標最多的會話

SELECT o.sid, s.osuser, s.machine, COUNT(*) AS num_curs
FROM v$open_cursor o
JOIN v$session s ON o.sid = s.sid
WHERE s.username = 'YOUR_APP_USER'
GROUP BY o.sid, s.osuser, s.machine
ORDER BY num_curs DESC;

鎖定 SID、OSUSER、MACHINE，反查應用伺服器節點。

Step 3：查看該會話開啟的具體 SQL

SELECT o.sid, q.sql_text
FROM v$open_cursor o
JOIN v$sql q ON q.hash_value = o.hash_value
WHERE o.sid = :target_sid;

重點關注：是否有大量相似 SQL（未使用綁定變數）、未關閉的 ResultSet/Statement。

Step 4：代碼層面根因與修正

Java 代碼最佳實踐範本

// ✅ 正確：PreparedStatement 重用 + try-with-resources 自動關閉
String sql = "SELECT * FROM orders WHERE user_id = ? AND status = ?";
try (PreparedStatement ps = conn.prepareStatement(sql)) {
    for (UserTask task : tasks) {
        ps.setLong(1, task.getUserId());
        ps.setString(2, task.getStatus());
        try (ResultSet rs = ps.executeQuery()) {
            while (rs.next()) { /* process */ }
        } // rs 自動關閉
    }
} // ps 自動關閉

// ❌ 錯誤：循環內新建 Statement，無關閉
for (UserTask task : tasks) {
    Statement stmt = conn.createStatement(); // 每次開新游標
    ResultSet rs = stmt.executeQuery("SELECT * FROM orders WHERE user_id = " + task.getUserId());
    // 缺少 rs.close(), stmt.close()
}

臨時緩解與永久治本

• 臨時：ALTER SYSTEM SET open_cursors=2000 SCOPE=MEMORY; 立即生效，重啟失效。
• 永久：ALTER SYSTEM SET open_cursors=2000 SCOPE=SPFILE; 需重啟生效，或 SCOPE=BOTH 兩者兼顧。
• 治本：**代碼層面修復游標洩漏**。調大參數只是延緩爆發，終會再次觸頂。

「游標洩漏是 Java 應用連接 Oracle 的頭號殺手。」建立代碼審查清單：每個 createStatement/prepareStatement 必須有對應 close，循環外建立、循環內重用、try-with-resources 統管生命週期。