C++/CLI通过异步方法打开WPF窗口时出现阻塞问题

问题根源 #

在UI线程调用LoginAsync().Wait()会触发死锁：OidcClient的异步流程需要回到UI线程创建并显示WebView2窗口，但UI线程被Wait()阻塞，导致后续UI操作无法执行，窗口无法打开。

解决方案 #

1. 异步调用到底，避免阻塞UI线程 #

不要在UI线程使用Wait()或Result这类阻塞方法，改用C++/CLI的异步语法（co_await）完成整个调用链：

// 示例：UI按钮点击事件的异步处理
task<void> LoginButton_Clicked(Object^ sender, RoutedEventArgs^ e)
{
    auto oidcClient = gcnew OidcClient(clientOptions);
    auto result = co_await oidcClient->LoginAsync();
    
    // 处理认证结果
    if (result->IsError)
    {
        // 错误处理逻辑
    }
    else
    {
        // 成功后的业务逻辑
    }
}

2. 修正自定义IBrowser的InvokeAsync实现 #

确保WebView2窗口的创建、初始化和导航全程在UI线程执行，用TaskCompletionSource异步等待认证结果：

ref class WpfWebView2Browser : IBrowser
{
public:
    task<BrowserResult^> InvokeAsync(BrowserOptions^ options) override
    {
        auto tcs = gcnew TaskCompletionSource<BrowserResult^>();
        
        // 调度到UI线程执行窗口创建逻辑
        Application::Current->Dispatcher->BeginInvoke(gcnew Action([=]()
        {
            auto window = gcnew Window();
            window->Width = 800;
            window->Height = 600;
            window->Title = options->Title;
            
            auto webView = gcnew WebView2();
            window->Content = webView;
            
            // 初始化WebView2并绑定导航事件
            webView->CoreWebView2InitializationCompleted += gcnew TypedEventHandler<WebView2^, CoreWebView2InitializationCompletedEventArgs^>(
                [=](WebView2^ sender, CoreWebView2InitializationCompletedEventArgs^ args)
                {
                    if (!args->IsSuccess)
                    {
                        tcs->SetResult(gcnew BrowserResult(BrowserResultType::Error, args->Exception->Message));
                        window->Close();
                        return;
                    }
                    
                    // 监听导航完成，捕获回调URL
                    sender->CoreWebView2->NavigationCompleted += gcnew TypedEventHandler<CoreWebView2^, CoreWebView2NavigationCompletedEventArgs^>(
                        [=](CoreWebView2^, CoreWebView2NavigationCompletedEventArgs^ navArgs)
                        {
                            auto url = sender->Source->ToString();
                            if (url->StartsWith(options->RedirectUri))
                            {
                                tcs->SetResult(gcnew BrowserResult(BrowserResultType::Success, url));
                                window->Close();
                            }
                        });
                    
                    sender->CoreWebView2->Navigate(options->StartUrl);
                });
            
            webView->EnsureCoreWebView2Async(nullptr);
            window->ShowDialog();
        }));
        
        return tcs->Task;
    }
};

3. 确认同步上下文配置 #

如果应用是原生C与C/CLI混合模式，需在WPF组件启动阶段（UI线程）设置正确的同步上下文：

// 应用初始化时执行（必须在UI线程）
auto syncContext = gcnew DispatcherSynchronizationContext(Application::Current->Dispatcher);
SynchronizationContext::SetSynchronizationContext(syncContext);

关键注意事项 #

• 所有WPF控件（包括WebView2）的创建和操作必须在UI线程执行，禁止在后台线程直接操作UI元素。
• C++/CLI异步编程遵循“异步到底”原则，从事件处理到业务逻辑全程使用co_await，避免阻塞调用打断同步上下文。

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