Win32版WebView2官方示例运行后仅显示空白窗口问题排查

问题描述 #

学习MS WebView2时，基于官方Win32示例代码做最小修改（移除W依赖），通过CMake构建运行后，窗口仅显示空白内容，预期应加载Bing页面。运行仅收到无关警告，附上实际代码及CMake配置，请求排查问题原因。

核心排查方向 #

1. WebView2初始化与导航逻辑检查 #

• 确认CreateCoreWebView2Controller调用是否成功，异步回调是否正确处理：
  • 检查回调中的HRESULT返回值，若不为S_OK则说明初始化失败，需打印错误码定位问题。
  • 确保在初始化完成后调用ICoreWebView2::Navigate，且传入正确的宽字符URL（如L"https://www.bing.com"）。移除W依赖后若使用多字节字符集，需注意字符串类型转换，避免因参数类型不匹配导致导航失败。

2. 控件与窗口的绑定与尺寸设置 #

• 检查ICoreWebView2Controller::SetBounds是否正确设置控件尺寸，需与窗口客户区大小匹配：
  • 可在初始化回调中打印控件宽高，确认是否为有效数值（非0）。
  • 窗口过程（WindowProc）中需处理WM_SIZE消息，调用ICoreWebView2Controller->NotifyParentWindowPositionChanged()并重新设置控件尺寸，避免窗口 resize 后控件未适配。

3. CMake配置正确性 #

• 确认CMake已正确引入WebView2依赖：
  • 需包含find_package(WebView2 REQUIRED)并在链接时添加WebView2::WebView2。
  • 检查字符集设置：若移除W依赖后使用多字节字符集，需确保WebView2 API调用时字符串类型兼容（优先统一使用宽字符以适配WebView2原生API）。

4. 运行时环境验证 #

• 检查是否安装WebView2 Runtime，版本是否符合要求：
  • 调用GetAvailableCoreWebView2BrowserVersionString获取当前可用Runtime版本，确认Runtime已正确安装。
  • 若Runtime缺失，WebView2控件无法初始化，会直接显示空白窗口。

代码与配置检查示例 #

关键代码片段验证 #

确保初始化回调中包含完整的导航与尺寸设置逻辑：

HRESULT AppWindow::OnCreateCoreWebView2ControllerCompleted(HRESULT result, ICoreWebView2Controller* controller)
{
    if (FAILED(result)) {
        // 打印错误信息，例如使用OutputDebugString
        char errMsg[256];
        sprintf_s(errMsg, "WebView2初始化失败: 0x%08X", result);
        OutputDebugStringA(errMsg);
        return result;
    }

    m_controller = controller;
    m_controller->get_CoreWebView2(&m_webView);

    // 绑定窗口尺寸
    RECT clientRect;
    GetClientRect(m_mainWindow, &clientRect);
    m_controller->SetBounds(clientRect);

    // 导航到目标页面
    m_webView->Navigate(L"https://www.bing.com");

    return S_OK;
}

CMake配置示例 #

确保依赖链接正确：

cmake_minimum_required(VERSION 3.14)
project(WebView2Demo)

# 查找WebView2包
find_package(WebView2 REQUIRED)

add_executable(WebView2Demo main.cpp)
# 链接WebView2库
target_link_libraries(WebView2Demo PRIVATE WebView2::WebView2)
# 若使用多字节字符集，添加以下设置（可选，建议优先用宽字符）
# target_compile_definitions(WebView2Demo PRIVATE _MBCS)

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