Task.Unwrap()抛出AggregateException时，根本原因在被unwrap的内层Task中；需检查其Result是否为Faulted任务，并调试outerTask.Result.Exception.InnerExceptions定位原始异常。
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 内层 —— 二者执行时机和异常触发路径完全不同。
典型错误写法：
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
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 是怎么创建、怎么失败的。
