CodeGym /課程 /C# SELF /呼叫堆疊與自訂例外的建立

呼叫堆疊與自訂例外的建立

C# SELF
等級 13, 課堂 3
開放

1. 認識呼叫堆疊 (Call Stack)

上次課程我們有稍微提到呼叫堆疊,這次來細講一下。

想像一下:使用者在 app 裡按了一個按鈕。這個按鈕會叫 OnClick()(「按鈕被按下」),然後它又去叫 LoadData()(載入資料),再來又叫 ReadFromFile()(從檔案讀取)。

突然在 ReadFromFile() 出錯了——檔案找不到。誰的錯?

要搞清楚,程式就會「往回追蹤」:從 ReadFromFile() → LoadData() → OnClick()。這條路徑就叫呼叫堆疊——就像一疊盤子,最上面的會先掉下來。

程式會一路往下走這疊盤子,直到遇到合適的 catch,但同時會執行所有在路上的 finally,確保所有東西都被關掉、釋放、收拾好。

在寫程式時,呼叫堆疊就是一個清單,記得誰叫了誰,這樣出事時就能回頭找出問題的根源。

它是怎麼運作的

當程式在跑,每次呼叫一個方法(或 function)就會在呼叫堆疊(清單)加一行。如果執行時發生例外,.NET 的 Exception 物件會記下這個堆疊的資訊:哪些方法、什麼順序被叫到,最後導致錯誤。

2. 呼叫堆疊到底有什麼用

呼叫堆疊是你 debug(除錯)複雜 bug 的好朋友。

  • 它不只告訴你發生什麼事,還有發生在哪、誰害的。
  • 有時候你看著堆疊,會驚訝程式怎麼會走到這種狀態(尤其是有人不小心傳錯參數)。

常見情境: 假設你有個超大的專案,方法互相呼叫,層層堆疊。有一天突然冒出 NullReferenceException,你根本搞不懂程式怎麼跑到那。打開堆疊——整條呼叫鏈都在那,馬上就知道該從哪裡下手。

範例:

class MyClass 
{
    public void MethodA()     { MethodB(); }
    
    public void MethodB()     { MethodC(); }
    
    public void MethodC()     {
        throw new Exception("錯誤!");
    }    

    public void Main() 
    {
        try 
        { 
            MethodA(); 
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.StackTrace);
        }        
    }
}

3. 怎麼寫自己的例外

有時內建的例外不夠用

.NET 有一堆內建例外(ArgumentNullException、InvalidOperationException 等等),但有時還是不夠:

  • 你的 app 有自己的「遊戲規則」:比如說用戶不能一次買超過 10 個商品,或你的商業邏輯裡金額不能是負的。
  • 你想把應用邏輯的錯誤跟「系統」錯誤分開。

這時就會想自己寫一個——反正可以嘛!


using System;

// 自訂例外:找不到用戶
public class UserNotFoundException : Exception
{
    // 基本建構子
    public UserNotFoundException() : base("用戶沒找到。") { }

    // 帶訊息的建構子
    public UserNotFoundException(string message) : base(message) { }

    // 帶訊息和內部例外的建構子
    public UserNotFoundException(string message, Exception inner) : base(message, inner) { }
}
自訂例外 UserNotFoundException 範例

建構子簡單說

  • 沒參數——會用預設訊息
  • 可以自己加訊息——有時想多補充細節
  • 帶內部例外(inner)——如果錯誤是「包在另一個錯誤裡」,就不會漏掉重要資訊。

怎麼用自己的例外

假設我們在任務管理 app 裡寫一個找用戶的方法:

using System;

public class UserService
{
    public string FindUserNameById(int userId)
    {
        // 「找」用戶,沒找到就丟例外
        if (userId != 42)
            throw new UserNotFoundException($"用戶 id {userId} 沒找到。");

        return "馬克西姆";
    }
}

在主程式裡:

// 在 Main
var service = new UserService();
try
{
    string name = service.FindUserNameById(17);
    Console.WriteLine("用戶名稱: " + name);
}
catch (UserNotFoundException ex)
{
    Console.WriteLine("找用戶出問題: " + ex.Message);
    // 呼叫堆疊也可以用 ex.StackTrace 拿到
}

如果我們傳的 id 不是 42,就會得到:

找用戶出問題: 用戶 id 17 沒找到。

4. 為什麼要寫自己的例外

Log 跟錯誤分類

假設你的 app 有一堆不同錯誤,要分開處理。比如資料庫錯誤要 log 成「致命」,用戶錯誤要顯示紅字,網路錯誤要重試。用例外型別來分組超方便。

OOP 跟繼承

可以幫你的領域錯誤做一個繼承結構:

public class MyAppException : Exception { ... }
public class OrderException : MyAppException { ... }
public class ProductException : MyAppException { ... }
public class TooManyItemsInOrderException : OrderException { ... }

現在只要抓 MyAppException,就能處理所有你的領域錯誤;如果想對「訂單太大」有特別反應,就抓最細的那個。

5. 寫自訂例外要注意什麼

  • 不要為了丟例外而丟例外
    只有在這些情況才寫自己的例外:
    • 真的讓程式碼更好懂
    • 有可能會被呼叫端抓到
    • 想多給呼叫端一些資訊(用欄位/屬性)
  • 好習慣:序列化
    .NET 的內建例外都支援序列化(比如要傳到網路上)。簡單 app 很少用到,但進階情境——加上 [Serializable] 屬性,還有序列化建構子(看 官方文件)。學習時可以不用管,工作上要問問 team lead :)
    序列化就是把物件變成方便儲存或傳輸的格式(像寫到檔案或網路)。我們之後會再細講序列化。

6. 呼叫堆疊的細節:哪裡會搞混

呼叫堆疊只會顯示發生例外的那條路徑。如果你抓到例外又丟一個新的,但沒指定「內部」例外(就是 Exception(string, Exception inner) 的建構子),你就會把原本的錯誤來源弄丟。這叫「堆疊被蓋掉」。

這樣不好:

try
{
    // 這裡出錯
}
catch (Exception ex)
{
    throw new Exception("發生未知錯誤。"); // 原本的堆疊不見了!
}

這樣才對:

try
{
    // 這裡出錯
}
catch (Exception ex)
{
    throw new Exception("發生未知錯誤。", ex); // 保留原本的堆疊!
}

這樣 StackTrace 裡就會有第一個錯誤的路徑,也有你新的訊息。

7. 實用建議和常見錯誤

  • 不要用例外來控制一般邏輯(比如「跳出迴圈」——有更優雅的寫法!)。
  • 只抓你需要的例外型別——每次都抓 Exception 不一定好(可能會「吞掉」你不該吞的錯誤)。
  • 遇到複雜錯誤一定要 log 堆疊。這會讓你 debug 少掉一堆麻煩。
  • 用內部例外——這樣才不會漏掉錯誤的根本原因。
  • 自訂例外要寫得清楚——讓一年後看的人也懂為什麼會出這個錯。
2
任務
C# SELF, 等級 13, 課堂 3
上鎖
處理例外時輸出呼叫堆疊
處理例外時輸出呼叫堆疊
2
任務
C# SELF, 等級 13, 課堂 3
上鎖
建立與處理自訂例外
建立與處理自訂例外
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION