WinUI 3中如何安全地将AsyncLocal值流动到UI线程

• DispatcherQueue的TryEnqueue方法设计上不会自动流动当前线程的ExecutionContext，而AsyncLocal<T>的存储、调用堆栈信息都依附于ExecutionContext，这和Task.Run这类API默认自动流动上下文的行为不同，因此直接入队的委托会出现AsyncLocal值丢失、堆栈跟踪断裂的问题。

手动捕获当前ExecutionContext，在DispatcherQueue委托中运行上下文即可。ExecutionContext采用写时复制机制，委托内部对AsyncLocal的修改不会影响原线程的上下文，完全匹配你给出的示例预期，且不会携带你担心的额外不必要信息：

注意：同步上下文（SynchronizationContext）、线程级区域设置、线程优先级等线程专属属性不属于ExecutionContext的流动范围，手动流动不会将这些内容带入UI线程，也不会修改UI线程的原有上下文。

修正后的可运行代码如下：

var asyncLocal = new AsyncLocal<int>();
asyncLocal.Value = 10;

var dispatcherQueue = _mainWindow.DispatcherQueue;
var taskCompletionSource = new TaskCompletionSource();

// 捕获当前线程的执行上下文
var executionContext = ExecutionContext.Capture();
dispatcherQueue.TryEnqueue(new DispatcherQueueHandler(() =>
{
    // 在捕获的上下文中运行委托逻辑
    if (executionContext != null)
    {
        ExecutionContext.Run(executionContext, _ =>
        {
            Debug.Assert(asyncLocal.Value == 10);
            asyncLocal.Value = 20;
            Debug.Assert(asyncLocal.Value == 20);
            taskCompletionSource.SetResult();
        }, null);
    }
    else
    {
        // 上下文捕获失败时走fallback逻辑
        taskCompletionSource.SetResult();
    }
}));

await taskCompletionSource.Task;
Debug.Assert(asyncLocal.Value == 10);

上述流动ExecutionContext的操作已经会自动携带调用堆栈信息，如果你使用的是.NET 5+版本，运行时默认已经启用了跨异步调用的堆栈跟踪增强支持，无需额外配置即可在UI线程的委托中看到完整的调用链。如果堆栈仍有缺失，可以在项目文件中加入以下配置增强堆栈记录：

<PropertyGroup>
  <ErrorStackTraceSupport>true</ErrorStackTraceSupport>
</PropertyGroup>

内容的提问来源于stack exchange，提问作者Rick de Water