CodeGym /課程 /C# SELF /在非同步操作中的錯誤處理( async/ await)

在非同步操作中的錯誤處理( async/ await)

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

1. 介紹

先從一個重要問題開始:為什麼不能單純相信非同步方法並期望它們永遠順利?對檔案的操作經常會拋出例外——檔案可能被刪除、磁碟空間不足、權限不夠或檔案被鎖住。在同步程式碼中你會在熟悉的 try-catch 區塊中捕捉問題。在非同步程式碼裡原則是一樣的,但有些細節要注意:錯誤不一定在呼叫方法的那一刻發生,而是在操作真正執行時才發生。

錯誤發生的時機

在同步程式碼裡,透過 StreamReader.Read() 讀取時,例外會直接在呼叫那一行拋出——你在 catch 裡捕捉到就好。
在非同步程式碼(await stream.ReadAsync())中,錯誤不會在操作啟動時丟出,而會在你 await 的時候——也就是任務完成並帶著錯誤時。如果忘了寫 await,錯誤可能會暫時「不可見」。

2. 如何在非同步方法中捕捉例外

先看一個典型範本:


try
{
    using FileStream fs = new FileStream("myfile.txt", FileMode.Open);
    byte[] buffer = new byte[1024];
    int bytesRead = await fs.ReadAsync(buffer, 0, buffer.Length);
    // 後續處理...
}
catch (IOException ex)
{
    Console.WriteLine("輸入輸出錯誤: " + ex.Message);
}
catch (UnauthorizedAccessException ex)
{
    Console.WriteLine("沒有檔案存取權限: " + ex.Message);
}
catch (Exception ex)
{
    Console.WriteLine("未知錯誤: " + ex);
}

對,就這麼簡單——在非同步方法中也用熟悉的 try-catch。重點是該方法本身要宣告為 async,不然編譯器會抱怨。

重要的細節:把 await 放在哪裡


Task<int> readTask = fs.ReadAsync(buffer, 0, buffer.Length);
// ... 這裡不小心忘了 await 或是沒有處理

在這種情況下,若發生錯誤,它會被包在那個任務(Task)裡,你不會知道,除非你之後去取得結果——比如對 readTask 做 await 或檢查 Task.Exception。如果完全忘了 await,任務可能會以錯誤完成,而沒有人告訴你。

3. 為什麼不處理錯誤的非同步程式碼很危險

情境 1:「Fire and forget」— 新手的陷阱


FileStream fs = new FileStream("file.txt", FileMode.Open);
byte[] buffer = new byte[8000];
fs.ReadAsync(buffer, 0, buffer.Length);
// 接著程式繼續執行其他事

讀取操作會在背景執行,如果它以錯誤結束,沒有任何 catch 會捕捉到。例外會躲在任務裡。這個模式叫做「fire and forget」,在真實應用中可能導致關鍵錯誤遺失和資源洩漏。

情境 2:非同步方法但沒寫 await


Task t = MyAsyncMethod();
// ... 做了別的事,之後忘了處理 t

發生在 MyAsyncMethod 裡的錯誤,只有在你明確等待該任務(await t 或 t.Wait())時才會被拋出。

4. 正確捕捉非同步任務錯誤的方法

策略 1:總是使用 await


try
{
    await SomeFileOperationAsync();
}
catch (Exception ex)
{
    Console.WriteLine("出了一些問題: " + ex.Message);
}

這樣例外會在等待點被拋出,不會丟失。

策略 2:用 .ContinueWith 來處理

如果因為某些原因不使用 await,可以用 ContinueWith 加上錯誤處理器:


var task = fs.ReadAsync(buffer, 0, buffer.Length);
task.ContinueWith(t =>
{
    if (t.Exception != null)
        Console.WriteLine("非同步讀取時發生錯誤: " + t.Exception.InnerException);
}, TaskContinuationOptions.OnlyOnFaulted);

老實說,在現代 C# 應用裡不常這樣做——async/await 讓程式碼更簡潔可讀。

非同步檔案操作常見的例外

5. 範例:帶錯誤處理的非同步讀取

把這個邏輯放進你的應用中:


using System;
using System.IO;
using System.Threading.Tasks;

namespace FileAsyncDemo
{
    class Program
    {
        static async Task Main()
        {
            string path = "bigfile.txt";
            byte[] buffer = new byte[4096];

            try
            {
                using FileStream fs = new FileStream(path, FileMode.Open);
                int bytesRead = await fs.ReadAsync(buffer, 0, buffer.Length);
                Console.WriteLine($"已從 {path} 讀取 {bytesRead} 位元組");
            }
            catch (FileNotFoundException ex)
            {
                Console.WriteLine("找不到檔案: " + ex.Message);
            }
            catch (UnauthorizedAccessException ex)
            {
                Console.WriteLine("沒有檔案存取權限: " + ex.Message);
            }
            catch (IOException ex)
            {
                Console.WriteLine("讀寫錯誤: " + ex.Message);
            }
            catch (Exception ex)
            {
                Console.WriteLine("其他錯誤: " + ex.Message);
            }
        }
    }
}

重要注意事項

如果你在 Main 裡沒有使用 await,而只是做像是 Task result = SomeAsyncMethod();——錯誤會「保持沉默」,直到你真正去取回結果時才會顯現。

6. 最常見的錯誤與踩雷

忘了在非同步方法上加 await——錯誤不會即時冒出,程式行為變得不可預期。

不把非同步呼叫包在 try-catch 中——應用會在第一次故障時崩潰。

只捕捉一般的 Exception,忽略像 UnauthorizedAccessException 或 OperationCanceledException 這類特定例外——會導致診斷資訊不足。

使用「fire and forget」的任務卻沒有明確的錯誤記錄——例外會在 Task 內部遺失。

以為任務完成就代表成功。你需要明確等待結果(await)並處理可能的例外。

2
任務
C# SELF, 等級 42, 課堂 3
上鎖
讀取檔案時的錯誤處理
讀取檔案時的錯誤處理
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION