WPF应用内托管ASP Web Api时进程无法正常优雅停止如何解决

• 核心原因是WPF UI线程同步上下文死锁：WPF的Application_Exit事件运行在UI单线程上下文中，你调用StopAsync().GetAwaiter().GetResult()会同步阻塞UI线程等待异步方法执行完成；而StopAsync内的await _host.StopAsync默认会捕获当前同步上下文，尝试将后续执行逻辑调度回UI线程，此时UI线程已经处于阻塞状态，两者互相等待形成死锁，导致StopAsync永远无法执行完成，进程也无法退出。
• 次要可能原因：ASP Core 主机的部分后台服务未正常响应停止信号，导致主机停止流程被挂起。

1. 首先修复异步等待的上下文捕获问题，在所有异步调用处添加ConfigureAwait(false)，禁止异步方法捕获UI同步上下文，修改ASP项目的StartAsync和StopAsync方法：

//StartAsync is called by the WPF app
public static Task StartAsync(CancellationToken token)
{
    _host = CreateHostBuilder(Array.Empty<string>()).Build();
    // 不捕获同步上下文，避免调度回UI线程
    return _host.StartAsync(token).ConfigureAwait(false);
}

public static async Task StopAsync(CancellationToken token)
{
    using (_host)
    {
        // 不捕获同步上下文，避免调度回UI线程
        await _host.StopAsync(token).ConfigureAwait(false);
    }
    _host = null;
}

2. 修改WPF的Application_Exit逻辑，将停止操作调度到线程池执行，避开UI线程上下文，可额外添加超时控制避免极端情况进程卡死：

private void Application_Exit(object sender, ExitEventArgs e)
{
    using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(5));
    try
    {
        // 放到线程池执行，避免UI线程死锁
        Task.Run(() => RestApiProgram.StopAsync(cts.Token)).Wait();
    }
    catch (OperationCanceledException)
    {
        // 停止超时直接强制退出进程
        Environment.Exit(0);
    }
}

修改后再次测试关闭WPF窗口，主机停止逻辑不会再尝试调度回UI线程，死锁被解除，进程会正常退出。如果仍有残留，可在调试时查看线程窗口，确认是否有自定义的后台托管服务未实现正常停止逻辑，补充对应的StopAsync释放逻辑即可。

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