WinUI 3跨线程访问UI线程问题：Timer触发异常排查与解决

异常原因 #

WinUI3（尤其是桌面版）的窗口调度模型与UWP存在本质差异：

• UWP依赖CoreApplication.MainView.CoreWindow的CoreDispatcher完成UI线程调度，且UWP以单窗口为核心场景，CoreWindow的生命周期与UI线程强绑定。
• WinUI3基于Windows App SDK的DispatcherQueue机制管理UI线程任务，CoreApplication.MainView.CoreWindow不再是可靠的UI调度入口：
  1. 当Timer回调触发时，MainView对应的CoreWindow可能未完成初始化、已被销毁，或当前活跃窗口并非MainView，导致获取的CoreDispatcher处于无效状态。
  2. WinUI3对CoreDispatcher的调用时机校验更严格，当关联的CoreWindow未处于激活状态或线程上下文失效时，直接调用RunAsync会抛出“方法在意外时间被调用”异常。

解决方法 #

替换UWP的CoreDispatcher调用逻辑，改用WinUI3原生的DispatcherQueue完成跨线程UI操作：

步骤1：在UI线程获取DispatcherQueue实例 #

在窗口/控件的构造函数或UI线程初始化逻辑中，保存当前UI线程的DispatcherQueue（确保在UI线程执行此操作）：

private DispatcherQueue _uiDispatcher;

public MainWindow()
{
    InitializeComponent();
    // 在UI线程获取DispatcherQueue
    _uiDispatcher = DispatcherQueue.GetForCurrentThread();
}

步骤2：在Timer回调中调度UI操作 #

使用DispatcherQueue.TryEnqueue方法将UI操作投递到UI线程执行：

private void TimerCallback(object state)
{
    // 投递UI任务到UI线程
    _uiDispatcher.TryEnqueue(() =>
    {
        // 这里执行UI更新操作
        MyTextBlock.Text = DateTime.Now.ToString();
    });
}

如果是在页面或控件内部，也可以直接使用实例的DispatcherQueue属性：

private void TimerCallback(object state)
{
    this.DispatcherQueue.TryEnqueue(() =>
    {
        MyTextBlock.Text = DateTime.Now.ToString();
    });
}

WinUI3与UWP的核心差异 #

1. 窗口调度模型：
   • UWP以CoreApplication和CoreWindow为核心，UI线程与CoreWindow强绑定，CoreDispatcher是唯一的UI调度入口。
   • WinUI3桌面版采用DispatcherQueue作为UI调度核心，脱离了对CoreWindow的强依赖，支持多窗口场景，每个窗口的UI线程调度独立管理。
2. 生命周期管理：
   • UWP的CoreWindow生命周期由系统严格管控，始终与当前应用的活跃状态绑定。
   • WinUI3桌面版的窗口生命周期更贴近传统桌面应用，CoreApplication.MainView可能不对应当前活跃窗口，甚至在某些场景下未被初始化，导致原UWP代码获取的CoreDispatcher无效。
3. 调用时机校验：
   • WinUI3对CoreDispatcher的调用增加了更严格的上下文校验，当CoreWindow未处于激活状态或调度上下文失效时，直接调用RunAsync会触发异常，而UWP的校验逻辑相对宽松。

内容的提问来源于stack exchange，提问作者Paul Claessen