萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Java 異常處理六大反模式與最佳實踐重構指南

原始問題代碼(含 6 個錯誤)


OutputStreamWriter out = ...;
Connection conn = ...;
try {
    Statement stat = conn.createStatement();
    ResultSet rs = stat.executeQuery("select uid, name from user");
    while (rs.next()) {
        out.println("ID:" + rs.getString("uid") + ",姓名:" + rs.getString("name"));
    }
    conn.close();  // ⑶
    out.close();
} catch (Exception ex) {  // ⑵
    ex.printStackTrace(); // ⑴, ⑷
}

六大反模式詳細分析

反例一:吞沒異常

位置:catch 區塊僅 printStackTrace()。
危害:程式靜默失敗,調用方不知情,日誌難追蹤。
修正:記錄完整日誌、拋出業務異常、或實際處理(重試、降級、通知)。

反例二:捕獲過寬泛異常

位置:catch (Exception ex)。
危害:混淆 SQL 錯誤、IO 錯誤、邏輯錯誤,無法針對性處理。
修正:分別捕獲 SQLException、IOException 等具體異常;不可預期的異常向上拋出。

反例三:資源未在 finally 釋放

位置:conn.close()、out.close() 放在 try 區塊末尾。
危害:發生異常時跳過釋放,導致連線洩漏、檔案鎖定。
修正:使用 try-with-resources (Java 7+) 或 finally 區塊確保釋放。

反例四:錯誤資訊不足

位置:僅 printStackTrace。
危害:堆疊資訊缺乏業務上下文(如正在處理哪筆資料、哪個用戶)。
修正:拋出自訂異常並附帶上下文:throw new BizException("讀取用戶列表失敗", sqlEx);。

反例五:try 區塊過大

位置:整段邏輯包在單一 try。
危害:難以定位具體拋出異常的語句,錯誤處理邏輯混雜。
修正:縮小 try 範圍,僅包裹可能拋出檢查型異常的語句。

反例六:輸出資料不完整無提示

位置:迴圈中斷後,已輸出的資料不完整,下游系統誤以為完整。
危害:資料不一致、報表錯誤。
修正:緩衝輸出、或寫入「資料不完整」標記、或拋出異常讓上層決定回滾/重試。

重構後的最佳實踐代碼(Java 7+ try-with-resources)


try (Connection conn = dataSource.getConnection();
     OutputStreamWriter out = new OutputStreamWriter(response.getOutputStream());
     Statement stat = conn.createStatement();
     ResultSet rs = stat.executeQuery("SELECT uid, name FROM user")) {

    while (rs.next()) {
        out.write("ID:" + rs.getString("uid") + ",姓名:" + rs.getString("name") + "\n");
    }
    out.flush();

} catch (SQLException sqlEx) {
    log.error("查詢用戶資料失敗", sqlEx);
    throw new BizException("資料庫查詢異常", sqlEx);
} catch (IOException ioEx) {
    log.error("輸出回應失敗", ioEx);
    throw new BizException("資料輸出異常", ioEx);
}

核心原則總結

  1. 捕獲具體異常,勿用 Exception 一網打盡。
  2. 資源務必在 finally 或 try-with-resources 釋放。
  3. 異常需攜帶業務上下文,避免裸露堆疊。
  4. 縮小 try 範圍,單一職責。
  5. 考慮部分失敗對下游資料完整性的影響。
  6. 記錄結構化日誌(含 traceId、參數),便於追蹤。
copyright © 萬盛學電腦網 all rights reserved