.NET 6 WinForms调用EnsureCoreWebView2Async触发COMException问题排查

核心原因 #

.NET 6 WinForms的异步上下文处理和.NET Framework 4.7.2存在差异，即使是async标记的按钮点击事件，后续await后的代码可能不在原始UI线程上执行，导致WebView2的EnsureCoreWebView2Async在非UI线程被调用，触发COM线程模式异常。

具体修复步骤 #

• 修改WinFormsWebView.cs中的初始化逻辑
  在调用EnsureCoreWebView2Async前，先检查当前线程是否为UI线程，如果不是则通过Invoke切换到UI线程执行：

// 在WinFormsWebView的初始化方法中
public async Task InitializeAsync()
{
    if (!webView.InvokeRequired)
    {
        await webView.EnsureCoreWebView2Async(null);
    }
    else
    {
        // 切换到UI线程执行初始化
        await webView.Invoke(async () =>
        {
            await webView.EnsureCoreWebView2Async(null);
        });
    }

    // 后续的WebView2配置逻辑...
}

• 调整登录按钮的异步事件处理
  如果登录按钮的LoginBtn_Click方法中调用了WebView2的初始化，确保在调用前也确认UI线程上下文：

private async void LoginBtn_Click(object sender, EventArgs e)
{
    // 确保后续操作在UI线程执行
    if (this.InvokeRequired)
    {
        this.Invoke(async () => await PerformLoginAsync());
    }
    else
    {
        await PerformLoginAsync();
    }
}

private async Task PerformLoginAsync()
{
    // 这里放置原来的登录逻辑，包括初始化WebView2、调用OidcClient等
    var webView = new WinFormsWebView();
    await webView.InitializeAsync();
    // ...其他OidcClient相关代码
}

• 验证WebView2的线程亲和性
  WebView2组件本身是单线程亲和的，所有操作必须在创建它的线程（即UI线程）上执行。如果你的OidcClient回调逻辑中涉及WebView2操作，同样需要通过Invoke切换到UI线程。

额外说明 #

.NET Framework 4.7.2中，async事件处理的SynchronizationContext默认会绑定到UI线程，而.NET 6 WinForms在某些场景下（比如配置了全局异步上下文）可能会改变这一行为，导致await后线程切换。显式使用Invoke强制在UI线程执行WebView2相关操作，可以彻底解决线程模式冲突问题。

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