Java 連線 Oracle 避免 ORA-01000 游標洩漏：五大常見錯誤與最佳實踐

錯誤根因

ORA-01000: maximum open cursors exceeded 表示進程打開的游標數超過 OPEN_CURSORS 參數限制（默認 300）。Java 中每次調用 createStatement() 或 prepareStatement() 都會在數據庫端打開一個游標，若在循環中重複創建且未關閉，極快耗盡配額。

五大典型錯誤

1. 只開不關：調用 createStatement() 後從不調用 close()。
2. 循環內創建 Statement：for/while 循環中反覆 createStatement() 或 prepareStatement()。
3. 不使用 PreparedStatement：拼接 SQL 字串導致每次解析生成新游標，且存在注入風險。
4. 日期處理不當：在 SQL 中硬編碼 TO_DATE('...') 或直接拼接字串，未使用 setDate()/setTimestamp() 綁定變量。
5. ResultSet 未關閉：讀取完畢未調用 rs.close()，導致關聯游標殘留。

最佳實踐方案

1. Statement 移出循環 + 及時關閉

PreparedStatement pstmt = conn.prepareStatement("SELECT * FROM t WHERE id = ?");
try {
    for (int id : ids) {
        pstmt.setInt(1, id);
        ResultSet rs = pstmt.executeQuery();
        try {
            while (rs.next()) { /* 處理數據 */ }
        } finally {
            rs.close(); // 關閉 ResultSet 釋放游標
        }
    }
} finally {
    pstmt.close(); // 循環結束關閉 Statement
}

2. 使用 Try-with-resources (JDK 7+)

try (PreparedStatement pstmt = conn.prepareStatement(sql);
     ResultSet rs = pstmt.executeQuery()) {
    while (rs.next()) { /* ... */ }
} // 自動關閉 rs、pstmt，即使拋出異常

3. 合理設置 OPEN_CURSORS

治標不治本。生產環境建議設置 500~1000，但必須配合代碼規範，否則洩漏最終仍會擊穿任何閾值。

總結原則

• 誰創建，誰關閉：創建 Statement/PreparedStatement/ResultSet 的代碼塊負責在 finally 中關閉。
• 盡早關閉：讀完 ResultSet 立即 close()，不要等到方法結束。
• 統一異常處理：封裝 JdbcTemplate 或使用 Spring/MyBatis 等框架，由框架保證資源釋放。