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 讓程式碼更簡潔可讀。
非同步檔案操作常見的例外
- IOException — 磁碟故障、找不到檔案、路徑太長、裝置不可用等。
- UnauthorizedAccessException — 權限不足。
- ObjectDisposedException — 在操作結束前 stream 已被關閉。
- OperationCanceledException — 操作透過取消 token(CancellationToken)被取消。
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)並處理可能的例外。
GO TO FULL VERSION