c# ExceptionDispatchInfo 的作用和用法_技术教程

ExceptionDispatchInfo用于捕获并跨线程/延迟重抛异常且保留原始堆栈，通过Capture()快照异常状态、Throw()精准还原；不可用于null异常，async/await中通常无需手动使用。

ExceptionDispatchInfo 是用来“捕获并重新抛出异常”的工具

它解决的核心问题是：当异常在某个线程或上下文中被捕获后，你想把它原封不动地“搬运”到另一个线程（比如从 Task 内部抛到主线程）、或延迟抛出，又不想丢失原始堆栈信息。ExceptionDispatchInfo.Capture() 会把当前异常的完整状态（包括堆栈、TargetSite、内部异常链）快照下来，之后用 .Throw() 就能精准还原——这比直接 throw ex; 强得多，后者会重置堆栈。

为什么不能直接 throw ex;？

直接 throw ex; 会清空原始堆栈，只保留抛出点；而 throw;（无参数）虽保留堆栈，但只能在原始 catch 块里用。一旦你跳出这个作用域（比如把异常存到变量、跨线程传递、异步回调中再抛），就只能靠 ExceptionDispatchInfo。

throw ex; → 堆栈从这里开始，原始位置丢失
throw; → 只能在同一个 catch 中用，无法跨作用域
ExceptionDispatchInfo.Capture(ex).Throw(); → 堆栈、Source、Data 全部保留，可在任意地方调用

典型使用场景：跨线程/异步异常传播

常见于自定义任务调度、WPF/WinForms 同步上下文、或封装异步逻辑时需要把子任务异常“透传”给调用方。例如你在后台线程里执行一段操作，失败后想让 UI 线程收到原始异常：

try
{
    // 模拟后台工作
    throw new InvalidOperationException("数据库连接失败");
}
catch (Exception ex)
{
    // 捕获并保存异常快照
    var captured = ExceptionDispatchInfo.Capture(ex);
    
    // 切换到 UI 线程后抛出
    Dispatcher.Invoke(() => captured.Throw());
}

注意：captured.Throw() 是立即抛出的，不会返回；它等价于在捕获点原样重抛，所以外层 try/catch 能正常捕获到原始堆栈。

容易踩的坑

ExceptionDispatchInfo 不是万能兜底方案，几个关键限制必须清楚：

只能对已抛出的 Exception 实例调用 Capture()，不能对 null 或新构造的异常对象用（会抛 ArgumentNullException）
Throw() 之后代码不会继续执行（和 throw 一样），但不会自动终止线程——如果没被上层捕获，仍会按 .NET 默认策略处理（如 TaskScheduler.UnobservedTaskException）
在 async/await 链中，多数情况不需要手动用它：编译器生成的状态机已自动用 ExceptionDispatchInfo 处理异常传播；只有当你绕过 await（比如用 .GetAwaiter().GetResult() 或手动调度委托）时才需显式介入