WebView2在登录安全桌面中ICoreWebView2CreateCoreWebView2ControllerCompletedHandler回调未触发

一、回调未触发的核心修复方案 #

安全桌面的权限隔离、资源访问限制和消息循环特性，是导致WebView2异步回调失效的主要原因，对应修复如下：

1. 指定SYSTEM可访问的用户数据目录 #

WebView2默认使用当前用户AppData目录存储数据，但安全桌面下凭据提供者运行在SYSTEM上下文，无权限访问普通用户目录。需手动指定一个SYSTEM拥有读写权限的路径：

// 创建并配置环境选项
ICoreWebView2EnvironmentOptions* envOpts = nullptr;
HRESULT hr = CreateCoreWebView2EnvironmentOptions(&envOpts);
// 设置自定义数据目录（提前确保目录存在且SYSTEM有权限）
envOpts->put_AdditionalBrowserArguments(L"--user-data-dir=C:\\Windows\\Temp\\WebView2_CredProvider");

// 创建WebView2环境
ICoreWebView2Environment* env = nullptr;
hr = CreateCoreWebView2EnvironmentWithOptions(
    nullptr,
    L"C:\\Windows\\Temp\\WebView2_CredProvider",
    envOpts,
    Callback<ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler>(
        [this](HRESULT result, ICoreWebView2Environment* createdEnv) -> HRESULT {
            if (SUCCEEDED(result)) {
                // 继续创建控制器
                return createdEnv->CreateCoreWebView2Controller(m_hWnd, m_controllerCallback.Get());
            }
            return result;
        }).Get());

envOpts->Release();

注意：提前用CreateDirectory创建目标目录，并通过SetNamedSecurityInfo配置ACL，确保SYSTEM用户有完全控制权限。

2. 使用同步初始化API绕过异步回调依赖 #

安全桌面的消息循环可能无法正常处理WebView2的异步回调消息，可使用CreateCoreWebView2ControllerSync同步创建控制器（需WebView2运行时版本≥1.0.1587.40）：

ICoreWebView2Environment* env = nullptr;
HRESULT hr = CreateCoreWebView2EnvironmentWithOptions(
    nullptr,
    L"C:\\Windows\\Temp\\WebView2_CredProvider",
    nullptr,
    &env);

if (SUCCEEDED(hr)) {
    ICoreWebView2Controller* controller = nullptr;
    // 同步创建控制器
    hr = env->CreateCoreWebView2ControllerSync(m_hWnd, &controller);
    if (SUCCEEDED(hr)) {
        ICoreWebView2* webview = nullptr;
        controller->get_CoreWebView2(&webview);
        webview->Navigate(L"https://your-target-url.com");
        
        // 保存接口指针用于后续释放
        m_controller = controller;
        m_webview = webview;
    }
    env->Release();
}

3. 确保窗口消息循环完整传递 #

凭据提供者的窗口过程不能过滤或丢弃未知消息，WebView2依赖WM_TIMER、WM_USER等消息完成初始化：

LRESULT CALLBACK CredProviderWndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam) {
    switch (uMsg) {
        case WM_DESTROY:
            // 释放WebView2资源
            CleanupWebView2Resources();
            PostQuitMessage(0);
            return 0;
        // 其他自定义消息处理
        default:
            // 必须传递未处理消息给DefWindowProc
            return DefWindowProc(hWnd, uMsg, wParam, lParam);
    }
}

二、EmbeddedBrowserWebView.dll析构崩溃修复 #

崩溃源于WebView2资源未在安全桌面环境下正确释放，或线程模型不匹配，修复步骤：

1. 主动提前释放WebView2资源 #

在凭据提供者的Release方法或窗口销毁前，按顺序释放所有WebView2接口：

void CleanupWebView2Resources() {
    if (m_webview != nullptr) {
        m_webview->Stop();
        m_webview->Release();
        m_webview = nullptr;
    }
    if (m_controller != nullptr) {
        m_controller->Release();
        m_controller = nullptr;
    }
}

注意：必须在创建WebView2的UI线程执行释放操作，禁止跨线程调用Release。

2. 禁用不必要的后台功能 #

通过ICoreWebView2Settings关闭后台刷新、上下文菜单等功能，减少退出时的资源竞争：

ICoreWebView2Settings* settings = nullptr;
m_webview->get_Settings(&settings);
settings->put_IsBackgroundRefreshEnabled(FALSE);
settings->put_AreDefaultContextMenusEnabled(FALSE);
settings->put_IsStatusBarEnabled(FALSE);
settings->Release();

3. 强制终止WebView2子进程 #

如果仍有崩溃，可在释放资源后主动终止WebView2的子进程：

ICoreWebView2_10* webview10 = nullptr;
hr = m_webview->QueryInterface(IID_PPV_ARGS(&webview10));
if (SUCCEEDED(hr)) {
    webview10->CloseAllBrowsers();
    webview10->Release();
}

三、安全桌面环境额外注意事项 #

• 全局安装WebView2运行时：必须使用全局安装的Evergreen运行时，安全桌面进程无法访问用户级安装的运行时文件。
• 禁用GPU加速：安全桌面通常不支持GPU渲染，需添加启动参数禁用：

  envOpts->put_AdditionalBrowserArguments(L"--disable-gpu --disable-software-rasterizer --no-sandbox");
  

• 匹配进程完整性级别：凭据提供者进程运行在SYSTEM完整性级别，确保WebView2运行时目录的ACL允许SYSTEM用户访问。

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