在MFC/Win32/VC++环境下使用WebView2弹窗显示网页遇阻

问题核心 #

调用window.open('https://www.microsoft.com')可正常弹出窗口，但打开本地磁盘HTML文件时无反应，且window.print()功能正常，说明WebView2的ExecuteScript机制本身正常，问题出在本地文件的URL格式、WebView2弹窗配置及本地权限限制上。

解决步骤 #

1. 修正本地文件的URL格式 #

WebView2要求本地文件必须使用file://协议，且路径需转义为标准URL格式：

• 绝对路径需将Windows反斜杠\替换为正斜杠/，开头添加三个斜杠（file:///），示例：file:///C:/Users/xxx/Documents/test.html

修改后的ExecuteScript代码示例：

if (m_pImpl->m_webView)
{
    // 本地文件路径转为标准file协议URL
    std::wstring localUrl = L"file:///C:/Your/Actual/Path/local.html";
    std::wstring script = L"window.open('" + localUrl + L"')";
    
    m_pImpl->m_webView->ExecuteScript(script.c_str(),
        Callback<ICoreWebView2ExecuteScriptCompletedHandler>(
            [](HRESULT error, PCWSTR result) -> HRESULT { return S_OK; })
        .Get());
}

2. 配置WebView2允许弹窗并处理弹窗事件 #

WebView2默认拦截弹窗，需通过配置和事件处理实现弹窗加载：

2.1 启用弹窗允许设置

在WebView2初始化阶段，配置Settings开启弹窗权限：

wil::com_ptr<ICoreWebView2Settings> settings;
m_webView->get_Settings(&settings);
settings->put_IsScriptEnabled(TRUE);
settings->put_AreDefaultScriptDialogsEnabled(TRUE);
// 关键配置：允许弹窗
settings->put_ArePopupsEnabled(TRUE);

2.2 处理NewWindowRequested事件

调用window.open时会触发该事件，需在事件中创建新窗口承载WebView2：

// 注册NewWindowRequested事件
wil::com_ptr<ICoreWebView2_2> webView2_2;
if (SUCCEEDED(m_webView->QueryInterface(IID_PPV_ARGS(&webView2_2))))
{
    webView2_2->add_NewWindowRequested(
        Callback<ICoreWebView2NewWindowRequestedEventHandler>(
            [this](ICoreWebView2* sender, ICoreWebView2NewWindowRequestedEventArgs* args) -> HRESULT
            {
                // 取消默认拦截行为
                args->put_Handled(TRUE);

                // 获取目标URL
                wil::unique_cotaskmem_string targetUri;
                args->get_Uri(&targetUri);

                // 创建新弹窗窗口（Win32示例，MFC可调整窗口创建逻辑）
                HWND popupWnd = CreateWindowEx(0, L"YourWindowClass", L"WebView2 Popup", WS_OVERLAPPEDWINDOW,
                    CW_USEDEFAULT, CW_USEDEFAULT, 800, 600, nullptr, nullptr, GetModuleHandle(nullptr), nullptr);

                // 在新窗口中初始化WebView2并加载目标URL
                CreateCoreWebView2ControllerAsync(popupWnd, targetUri.get());

                return S_OK;
            }).Get(), &m_newWindowRequestedToken);
}

3. 排查本地文件权限 #

• 确保本地HTML文件所在目录无系统权限限制（避免存放在C盘根目录、Windows系统目录等受保护路径）
• 若HTML引用了本地资源（CSS/JS），需使用相对路径或完整file://URL，避免跨路径访问限制

验证方式 #

1. 直接在WebView2中加载目标本地HTML，确认文件本身可正常显示
2. 在本地HTML中添加按钮直接调用window.open('file:///xxx')，排除ExecuteScript的调用问题

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