Java 異常處理：getMessage() 與 toString() 的區別與內部調用關係

代碼場景

class FuShuException extends Exception {
    private String str;
    FuShuException(String str) { this.str = str; }
    public String getMessage() { return str; }
    // 未重寫 toString()
}

try {
    // ...
} catch (FuShuException e) {
    System.out.println(e.toString()); // 輸出同 getMessage()
}

核心結論

Throwable.toString() 內部調用了 getLocalizedMessage()，而後者默認實現返回 getMessage() 的結果。因此未重寫 toString() 時，輸出內容與 getMessage() 完全一致。

源碼級解析（JDK 8）

// java.lang.Throwable
public String toString() {
    String s = getClass().getName();
    String message = getLocalizedMessage(); // 關鍵點
    return (message != null) ? (s + ": " + message) : s;
}

public String getLocalizedMessage() {
    return getMessage(); // 默認委托給 getMessage()
}

實際輸出對比

最佳實踐

• 僅需錯誤信息文本 → e.getMessage()
• 需包含異常類名（便於日誌排查） → e.toString() 或直接 logger.error("", e)
• 自定義異常類建議同時重寫 getMessage() 和 toString()，確保語義清晰。

一言以蔽之：toString() = 類名 + ": " + getMessage()。未重寫時兩者語義等價，但 toString() 攜帶類名更利於調試。