Java 基礎異常處理全景指南：從 HelloWorld 到 Struts 常見錯誤排查

一、HelloWorld 階段常見錯誤與對策

1. java: command not found / 'java' is not recognized

• 原因：未安裝 JDK 或 PATH 未包含 %JAVA_HOME%\bin。
• 對策：安裝 JDK，配置 JAVA_HOME 並追加到 PATH。

2. NoClassDefFoundError: hello (wrong name: Hello)

• 原因：類名大小寫不匹配（Java 區分大小寫）。
• 對策：執行 java Hello（類名首字母大寫）。

3. NoClassDefFoundError: Hello.class

• 原因：命令後誤帶 .class 後綴。
• 對策：直接輸入 java Hello。

二、深度剖析 NoClassDefFoundError 持續出現的根因

# 典型環境變數配置
JAVA_HOME=/home/jdk
CLASSPATH=$JAVA_HOME/jre/lib/tools.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/jre/lib:$JAVA_HOME/lib
PATH=$PATH:$JAVA_HOME/bin

三大核心解決方案

1. 當前目錄加入 CLASSPATH：export CLASSPATH=.:$CLASSPATH 或類聲明 public。
2. 系統路徑存在殘留 java.exe：Windows C:\Windows 或 C:\WinNT 下可能有舊版 java.exe，刪除或調整 PATH 順序確保優先調用 JDK bin 目錄下的。
3. package 聲明與目錄結構不符：若源碼有 package com.demo;，編譯後 .class 必須置於 com/demo/ 目錄，執行時需在父目錄下用全限定名 java com.demo.Hello。

三、Java 核心異常體系速查表

四、異常分類與處理機制

體系結構

Throwable
 ├─ Error              // JVM 級嚴重錯誤，不可恢復
 └─ Exception
     ├─ RuntimeException  // 非受檢異常：邏輯錯誤，編譯器不強制捕獲
     └─ 其他 Exception    // 受檢異常：必須 try-catch 或 throws 聲明

五大關鍵字語義

• try：包裹可能拋出異常的代碼塊。
• catch：捕獲並處理特定異常，順序從具體到通用（子類在前，父類在後）。
• finally：無論是否發生異常均執行，用於資源釋放（關流、鎖、連接）。
• throw：在方法內主動拋出異常對象。
• throws：在方法簽名聲明可能拋出的受檢異常。

經典 try-catch-finally 返回值陷阱

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

結論：finally 中的 return 會覆蓋 try/catch 的返回值與異常，生產代碼嚴禁在 finally 中使用 return。

五、java.lang.Error 常見成因與對策

• 外部資源（數據庫、Socket、文件句柄）未正確關閉導致洩漏。
• 重複關閉資源觸發底層異常。
• 外部資源本身異常（DB 掛掉、網絡分區）。

對策：try-with-resources（JDK 7+）或 finally 確保單次關閉；連接池複用資源；訪問前健康檢查。

六、空指針異常 (NullPointerException) 深度剖析與防禦編程

高危場景

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

// 2. 對可能為 null 的對象調用 equals/toString
String userName = request.getParameter("username");
if (userName.equals("root")) { ... }  // NPE 風險

// 3. Session 失效後直接取值
String userName = session.getAttribute("session.username").toString();

三種通用防禦模式

1. 默認值兜底：if (userName == null) userName = "";
2. 非空守衛：if (userName != null && userName.equals("root"))
3. 顯式錯誤提示：if (userName == null) { response.sendError(400, "缺少用戶名"); return; }

建議：統一採用「守衛條款」風格，提前返回，減少巢狀縮進。

七、Struts 1.x 經典錯誤代碼速查

總結

• 異常處理核心：預防 > 捕獲 > 恢復。
• 受檢異常強制業務邏輯感知錯誤；運行時異常暴露編程缺陷，應通過單元測試消除。
• 資源管理務必使用 try-with-resources 或標準 finally 關閉模式。
• 框架級錯誤（Struts 等）多源於配置與代碼不同步，建立「配置即代碼」的審查機制可大幅降低上線故障率。