Java 異常處理完整指南：從基礎分類到 Struts 實戰錯誤排查

第一支 Java 程式：常見執行錯誤與解決

環境設定問題

• 'java' is not recognized... → 未安裝 JDK 或 PATH 未含 %JAVA_HOME%\bin
• java: Command not found → Linux/Unix 環境變數未設定

類別載入錯誤

• NoClassDefFoundError: hello (wrong name: Hello) → 大小寫不符，Java 區分大小寫
• NoClassDefFoundError: Hello/class → 執行時勿加 .class 副檔名

深度解析 NoClassDefFoundError

即使類別名稱正確仍出現此錯誤，常見三大原因：

1. Classpath 缺少當前目錄：加入 . 到 CLASSPATH，或類別宣告加 public
2. PATH 順序錯誤：系統目錄（如 C:\Winnt）有舊版 java.exe 搶先被執行 → 刪除系統目錄下的 java.exe，確保使用 JDK bin 目錄版本
3. Package 宣告與目錄結構不符：檢查 package 陳述式與實際檔案路徑是否一致

Java 異常體系總覽

核心繼承結構

Throwable
├── Error          // 嚴重系統錯誤，通常不可恢復
└── Exception      // 應用程式可處理
    ├── RuntimeException  // 非受檢異常：邏輯錯誤、程式 Bug
    └── 其他 Exception    // 受檢異常：必須 try-catch 或 throws 宣告

常見異常速查表

五大關鍵字實戰：try、catch、throw、throws、finally

受檢 vs 非受檢異常的設計哲學

• 受檢異常：API 設計者預期呼叫者「知道並處理」，強制編譯期檢查
• 非受檢異常：通常表示程式邏輯錯誤（Bug），無法合理恢復，不強制處理

語法與最佳實務

boolean testEx() throws Exception {
    boolean ret = true;
    try {
        ret = testEx1();
    } catch (Exception e) {
        System.out.println("catch exception");
        ret = false;
        throw e;  // 重新拋出
    } finally {
        System.out.println("finally; return=" + ret);
        return ret;  // finally 中 return 會覆蓋 try/catch 的 return
    }
}

關鍵規則：

• catch 順序：由具體到一般（子類在前，父類在後）
• 多型捕捉：catch (IOException | SQLException e) (Java 7+)
• finally 保證執行（除非 System.exit() 或 JVM 崩潰），適合資源釋放
• throws 宣告在方法簽名，throw 拋出具體異常物件

兩大經典錯誤深度剖析

java.lang.Error：資源洩漏與外部系統異常

成因：

1. 外部資源（DB 連線、檔案、Socket）未關閉導致耗盡
2. 重複關閉導致外部系統錯誤
3. 外部資源本身異常

解決：使用前檢查可用性、確保單次關閉、同一操作共享連線（連線池）。

java.lang.NullPointerException：空指標防禦全攻略

核心原則：基本型別有預設值不會 NPE，所有 NPE 皆源自物件參考操作。

三大高風險情境與修正範例

// 情境 1：直接使用可能為 null 的請求參數
out.println(request.getParameter("username"));  // 危險！

// 修正：防禦性檢查
String userName = request.getParameter("username");
if (userName == null) userName = "";  // 方式1：預設空字串
if (userName != null && userName.equals("root")) { ... }  // 方式2：短路求值
if (userName == null) { /* 提示錯誤 */ }  // 方式3：顯式錯誤處理

// 情境 2：對 null 物件呼叫方法
String userName = request.getParameter("username");
if (userName.equals("root")) { ... }  // 危險！userName 可能為 null

// 修正：反轉比較順序或使用 Objects.equals (Java 7+)
if ("root".equals(userName)) { ... }
if (Objects.equals(userName, "root")) { ... }

// 情境 3：Session 失效導致屬性為 null
String userName = session.getAttribute("session.username").toString();  // 危險！

// 修正：安全取值
Object attr = session.getAttribute("session.username");
String userName = (attr != null) ? attr.toString() : "";

Struts 常見錯誤速查手冊

異常處理三大通用策略

1. 預設值策略：檢測到異常/空值，設定安全預設值（空字串、0、空集合）繼續執行
2. 跳過策略：檢測到異常，略過當前操作，跳轉至替代邏輯
3. 提示策略：檢測到異常，記錄日誌並回饋使用者友善錯誤訊息

這三種策略不僅適用 NPE，對所有可預期的業務異常皆有效。建議建立統一的異常處理基礎設施（如全域例外攔截器、統一錯誤頁面、結構化日誌），將防禦性程式設計內化為團隊規範。