C# WebView2初始化触发RPC_E_CHANGED_MODE COM异常求助

问题根源 #

你的代码存在三个核心问题，直接触发了COM线程模式冲突异常：

• WebView2必须在UI线程完成初始化：WebView2基于COM组件，要求创建控件的线程（此处为UI线程，因为ChartView继承自Panel，构造函数在UI线程执行）与初始化CoreWebView2的线程为同一个。你用Task.Run()把初始化逻辑丢到后台线程，违反了COM单线程单元（STA）模型，引发线程模式变更错误。
• Wait()阻塞UI线程引发死锁与冲突：Wait()会阻塞当前UI线程，而await chartWebView.EnsureCoreWebView2Async()完成后会试图回到原UI线程继续执行，此时UI线程已被阻塞，既造成死锁，又触发COM线程模式不兼容的异常。
• 构造函数中执行异步操作的逻辑错误：构造函数无法标记为async，直接在构造函数内处理异步初始化，会导致后续代码（如Navigate）在CoreWebView2未完成初始化时就执行，同时异步逻辑无法正确等待完成。

修复方案 #

将WebView2的初始化逻辑移到控件的Load事件中，利用UI线程的异步上下文安全处理初始化流程：

修复后的代码 #

class ChartView : Panel
{
#nullable enable
    private string? chartViewFileAddr { get; set; }
#nullable disable

    private WebView2 chartWebView { get; set; }
    private bool isInit = false;

    public ChartView(string? chartViewFileAddr) : base()
    {
        this.chartViewFileAddr = chartViewFileAddr ?? "";
        this.BorderStyle = BorderStyle.Fixed3D;
        this.Size = new System.Drawing.Size(300, 500);
        this.Location = new Point(0, 320);
        this.Name = "ChartWebView";

        // 初始化WebView2控件并添加到容器
        chartWebView = new WebView2();
        chartWebView.Size = this.Size;
        chartWebView.Location = new System.Drawing.Point(0, 0);
        this.Controls.Add(chartWebView);

        // 订阅Load事件，在UI线程执行异步初始化
        this.Load += ChartView_Load;
    }

    private async void ChartView_Load(object sender, EventArgs e)
    {
        if (!isInit)
        {
            // 在UI线程异步初始化CoreWebView2，无需切换线程
            await chartWebView.EnsureCoreWebView2Async(null);
            isInit = true;
            // 初始化完成后再执行导航
            chartWebView.CoreWebView2.Navigate("https://google.com");
        }
    }
}

关键修复点说明 #

1. 移至Load事件处理异步逻辑：WinForms控件的Load事件在UI线程触发，确保WebView2的初始化和后续操作都在同一个STA线程中执行，避免COM线程冲突。
2. 移除Task.Run与Wait()：直接在UI线程用await等待EnsureCoreWebView2Async完成，既不会阻塞UI线程，也符合异步操作的正确范式。
3. 延迟导航至初始化完成后：把Navigate调用放在await之后，确保CoreWebView2已经完全初始化，避免空引用或未就绪的错误。

额外注意事项 #

• 确保已正确安装WebView2运行时，或在项目中通过NuGet包配置打包WebView2运行时。
• 若需自定义WebView2环境（如指定用户数据目录），可在EnsureCoreWebView2Async中传入CoreWebView2Environment实例，而非传null。

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