如何在控制台应用或Windows服务中使用WebView2解决RPC_E_CHANGED_MODE异常

触发0x80010106 (RPC_E_CHANGED_MODE)异常的核心原因：
WebView2 WinForms控件底层依赖COM单线程单元（STA）线程模型，而默认控制台程序的主线程为多线程单元（MTA）模型。在CLR已经完成线程模型固化后，WebView2初始化流程尝试修改线程模型时就会触发该报错。同时，WinForms封装的WebView2控件本身绑定了UI消息循环和窗体生命周期，脱离WinForm对话框直接实例化控件，本身也不具备无UI运行的适配能力。

核心调整点 #

• 弃用WinForms封装的WebView2控件，直接使用底层CoreWebView2原生API
  不要通过new Microsoft.Web.WebView2.WinForms.WebView2()的方式初始化对象，改为直接调用CoreWebView2Environment.CreateAsync创建WebView2运行环境，这种模式不绑定特定UI框架，支持无窗口运行，全程不需要创建任何WinForm对话框或可见窗口。
• 单独创建STA模型的专属线程承载所有WebView2操作
  所有WebView2相关的初始化、页面加载、脚本执行逻辑，都要运行在提前设置为STA单元状态的线程上，禁止在控制台默认的MTA主线程直接执行WebView2初始化逻辑，从根源上避免线程模型冲突。
• 为WebView2专属线程启动独立的Windows消息循环
  WebView2是基于Windows消息驱动的组件，没有消息循环的场景下，所有异步操作的回调都无法触发，会出现初始化永久挂起的问题。需要在STA线程内启动标准Windows消息循环处理WebView2的内部消息。
• 避免强行跨线程同步阻塞异步操作
  禁止在非WebView2所属的线程上直接调用RunSynchronously阻塞异步任务，可通过线程同步信号（如ManualResetEventSlim）协调跨线程的初始化状态，脚本执行等交互操作也要通过线程封送的方式转到STA线程内执行。
• 指定可读写的用户数据缓存目录
  控制台或Windows服务场景下，WebView2默认的缓存路径通常对运行账号没有读写权限，必须在创建环境时显式指定一个程序有权限写入的目录作为userDataFolder参数值。

参考实现代码 #

using System;
using System.Threading;
using Microsoft.Web.WebView2.Core;
using System.Windows.Forms;

class Program
{
    private static CoreWebView2 _webViewInstance;
    private static readonly ManualResetEventSlim InitDoneEvent = new(false);

    [MTAThread]
    static void Main(string[] args)
    {
        // 启动专属STA线程承载WebView2全生命周期
        var webViewThread = new Thread(() =>
        {
            // 1. 创建WebView2运行环境，指定可读写的缓存路径
            var env = CoreWebView2Environment.CreateAsync(
                browserExecutableFolder: null,
                userDataFolder: @"C:\ProgramData\WebView2ConsoleCache",
                options: null).Result;

            // 2. 创建无UI的WebView2控制器，关联零窗口句柄（无需绘制界面）
            var controller = env.CreateCoreWebView2ControllerAsync(IntPtr.Zero).Result;
            _webViewInstance = controller.CoreWebView2;
            
            // 先导航到空白页，为脚本执行准备基础环境
            _webViewInstance.Navigate("about:blank");
            
            // 标记初始化完成，通知主线程
            InitDoneEvent.Set();
            
            // 启动消息循环，处理WebView2内部回调
            Application.Run();
        });
        
        // 提前设置线程为STA单元状态，避免初始化时修改线程模型报错
        webViewThread.SetApartmentState(ApartmentState.STA);
        webViewThread.IsBackground = false;
        webViewThread.Start();

        // 等待WebView2完成初始化
        InitDoneEvent.Wait();

        // 执行目标JS脚本
        var scriptResult = _webViewInstance.ExecuteScriptAsync("return 'test';").Result;
        Console.WriteLine($"脚本执行输出：{scriptResult}");

        // 退出消息循环，结束程序
        Application.Exit();
    }
}

Windows服务场景的额外注意事项 #

• 确保服务运行账号对指定的userDataFolder路径拥有读写权限，避免缓存目录初始化失败
• 编译程序的目标架构要和部署环境的WebView2 Runtime架构（x86/x64/ARM64）完全匹配
• 服务运行时不要依赖交互式桌面会话的资源，所有WebView2逻辑都要在后台STA线程内独立运行

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