Task.Unwrap 抛出 AggregateException 怎么定位根本原因
直接调用
Task.Unwrap()时如果内层
Task已经出错，它不会“吞掉”异常，而是把原始异常包装进
AggregateException并立即抛出。常见现象是：堆栈里看到
AggregateException，但 InnerExceptions 里只有一个非空项，且类型是业务逻辑异常（比如
NullReferenceException或自定义
ValidationFailedException）。
关键点在于：
Task.Unwrap()只负责“展平一层嵌套”，不改变异常传播行为。它等价于手动取
task.Result或
await task后再 await 内层 Task —— 所以异常源头一定在被 unwrap 的那个
Task<task>></task>的内层任务里。 检查被 unwrap 的变量是否来自
Task.Run(() => Task.Run(...))或
async Task<task>> GetNestedTask()</task>这类构造 不要只看外层
Task<task>></task>是否完成（
IsCompleted），要检查其
Result是否为 null、是否本身已
IsFaulted调试时在
Unwrap()前加断点，展开
outerTask.Result.Exception查看 InnerExceptions
为什么 await outerTask.Result 不等于 await outerTask.Unwrap()
这是最常踩的坑：
outerTask.Result是同步阻塞获取内层
Task<t></t>实例，而
outerTask.Unwrap()返回的是一个新
Task<t></t>，它会等待外层完成后再自动 await 内层 —— 二者执行时机和异常触发路径完全不同。
典型错误写法：
var nested = await outerTask; // ← 这里如果 outerTask 已 Faulted，会直接 throw AggregateException var result = await nested; // ← 永远执行不到
正确等效写法应是：
var unwrapped = outerTask.Unwrap(); // ← 返回 Task<T>，异常延迟到 await 时抛 var result = await unwrapped; // ← 此处才真正触发内层异常
Result强制同步等待 + 解包，可能引发死锁（尤其 UI 线程）
Unwrap()是纯组合操作，不触发执行，异常传播符合 async/await 规则 若需兼容 .NET Framework 4.0，
Unwrap()是唯一安全解法；4.5+ 可改用
await await outerTask（更直观）
在 ConfigureAwait(false) 场景下 Unwrap 的异常上下文丢失问题
当外层
Task<task>></task>在非默认上下文（如 ASP.NET Core 请求上下文、WinForms 同步上下文）中创建，且你对它调用了
.ConfigureAwait(false)，再
Unwrap()后 await，异常堆栈里可能丢失原始调用位置信息 —— 因为
Unwrap()创建的新
Task<t></t>继承的是外层 Task 的调度器设置，但内层 Task 的上下文捕获行为不受控制。 避免在外层 Task 构造阶段就丢掉上下文：比如
Task.Run(...).ConfigureAwait(false).Unwrap()是危险组合 若必须分离上下文，应在内层 Task 创建时明确控制，例如：
Task<Task<T>> outer = Task.Run(() => {
return Task.Run(() => DoWork()).ConfigureAwait(false); // ← 内层先配置
});
诊断时对比 unwrapped.Exception?.StackTrace和原始
outerTask.Result.Exception?.StackTrace，确认是否缺失帧
替代方案：什么时候该放弃 Unwrap 直接重构
频繁需要
Unwrap()往往说明设计上存在“任务嵌套过深”。多数情况可提前扁平化： 把
async Task<task>> GetDataAsync()</task>改成
async Task<t> GetDataAsync()</t>，内部用
await而非
return Task.Run(...)用
Task.WhenAll(tasks.Select(t => t.Unwrap()))替代
Task.WhenAll(tasks).Unwrap()（后者无效，
WhenAll返回的是
Task<task>[]></task>，不是
Task<task>></task>） 遇到
Task<task>>></task>，别层层
Unwrap().Unwrap()，用
await await await nested更清晰（C# 7.0+ 支持）
真正难缠的异常往往藏在被
Unwrap()掩盖的第二层异步调用里 —— 别只盯着
Unwrap方法本身，重点检查它所依赖的那个内层
Task是怎么创建、怎么失败的。
