C# Academy · 课时

ConfigureAwait 与异常流转

理解上下文捕获和 ConfigureAwait(false)；分别通过 await 和阻塞调用处理异常；了解 AggregateException 和最佳实践。

第 3 / 3 课8 个步骤

ConfigureAwait 与异常流转 是 CoddyKit 上的免费 C# Academy 课时。这是第 3 节课，共 3 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 3 节课。

上下文与异常

目标：

了解什么是上下文捕获
了解何时使用 ConfigureAwait(false)
了解异常如何通过 await 传播
了解阻塞为什么会导致 AggregateException

库的最佳实践

库方法应使用 ConfigureAwait(false)，避免在它们无法控制的用户界面或 Web 上下文中恢复执行。

using System;
using System.Threading.Tasks;

public static class NetLib
{
  // Library code should not assume a UI context. Use ConfigureAwait(false).
  public static async Task<string> FetchAsync()
  {
    await Task.Delay(100).ConfigureAwait(false); // do not capture context
    return "payload";
  }
}

public class Program
{
  public static void Main(string[] args)
  {
    // Console apps typically have no SynchronizationContext; this still runs fine.
    string s = NetLib.FetchAsync().GetAwaiter().GetResult();
    Console.WriteLine("Got: " + s);
  }
}

上下文规则

上下文捕获：

默认的 await 会尝试在捕获的上下文中恢复执行（用户界面/ASP.NET）
ConfigureAwait(false) 表示：不要捕获上下文，而是在线程池上恢复执行
当调用方阻塞上下文线程时，这有助于避免死锁
用户界面代码可能需要上下文来更新控件；库代码通常不应这样做

Await 与异常

使用 await 时，异常会以原始异常类型传播；请按通常方式捕获它。

using System;
using System.Threading.Tasks;

public class Program
{
  static async Task<string> BoomAsync()
  {
    await Task.Delay(50);
    throw new InvalidOperationException("boom");
  }

  public static void Main(string[] args)
  {
    // With await (inside async), exceptions rethrow as the original type.
    try
    {
      string r = BoomAsync().GetAwaiter().GetResult(); // emulate await in Main
      Console.WriteLine(r);
    }
    catch (InvalidOperationException ex)
    {
      Console.WriteLine("Caught: " + ex.GetType().Name + " - " + ex.Message);
    }
  }
}

阻塞与错误

使用 .Result 或 .Wait() 阻塞会将错误包装为 AggregateException；最好使用 await，以获得更清晰的错误传播过程。

using System;
using System.Threading.Tasks;

public class Program
{
  static async Task<int> FailsAsync()
  {
    await Task.Delay(30);
    throw new ArgumentException("bad arg");
  }

  public static void Main(string[] args)
  {
    try
    {
      // Blocking with .Result wraps the exception into AggregateException
      int x = FailsAsync().Result;
      Console.WriteLine(x);
    }
    catch (AggregateException ae)
    {
      Exception inner = ae.InnerException;
      Console.WriteLine("AggregateException -> " + (inner == null ? "null" : inner.GetType().Name));
    }
  }
}

最佳实践

准则：

在库中使用 ConfigureAwait(false)
在用户界面或 Web 代码中，需要上下文时就在调用线程上使用 await
避免使用 .Result/.Wait()；使用 await 捕获原始异常
如果需要，请使用包含上下文信息的消息进行 Log 并重新抛出

ConfigureAwait 行为

快速检查：ConfigureAwait(false) 告诉 await 做什么？

在交互式课程中回答

回顾

回顾：在库中使用 ConfigureAwait(false)；让用户界面或 Web 代码在需要上下文时自行决定。优先使用 await，以获得清晰的异常传播过程；阻塞会包装错误，并有导致死锁的风险。

免费开始

用 AI 导师学习 C# — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 93
课程: 346

免费开始学习查看完整课程

常见问题解答

「ConfigureAwait 与异常流转」课时是免费的吗？

是的 — 「ConfigureAwait 与异常流转」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 3 节课。

「ConfigureAwait 与异常流转」这节课中我会学到什么？

理解上下文捕获和 ConfigureAwait(false)；分别通过 await 和阻塞调用处理异常；了解 AggregateException 和最佳实践。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 3 节。

「ConfigureAwait 与异常流转」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 C# Academy