Win32 WebView2启动时无法聚焦HTML页面问题求助

开发Win32 WebView2轻量原生浏览器客户端时，启动后加载的HTML页面始终无法获得焦点。尝试过HTML内JS自动聚焦、C++与HTML双向回调触发聚焦等方案均无效，仅当触发弹出警告对话框这类操作后，页面才会正常获取焦点。以下是问题原因的分析思路及排查方向：

可能的核心原因 #

1. 窗口焦点未正确传递到WebView2控件 #

Win32原生窗口初始化后，焦点默认停留在主窗口而非WebView2子控件上。若主窗口未处理焦点相关消息并转发给WebView2，控件无法主动获取焦点，进而导致HTML页面无法接收焦点事件。

2. 聚焦操作时机过早 #

如果在WebView2的CoreWebView2对象未完全初始化、页面未完成加载时就执行聚焦逻辑（比如JS自动聚焦或C++回调触发），此时页面DOM可能尚未就绪，聚焦操作会失效。

3. WebView2进程焦点状态异常 #

WebView2依赖的Edge渲染进程在启动时，可能因初始化顺序问题导致焦点状态未正确同步。只有当外部操作（如弹窗）触发进程内的焦点刷新逻辑时，才会修正这个异常状态。

排查与解决方向 #

• 主动传递焦点到WebView2控件
  在Win32窗口的WM_SETFOCUS消息处理中，将焦点主动设置到WebView2的窗口句柄上。示例代码：

  case WM_SETFOCUS:
      if (m_webViewHwnd != nullptr) {
          SetFocus(m_webViewHwnd);
      }
      break;
  

  其中m_webViewHwnd可通过ICoreWebView2Controller->get_Hwnd()获取。

• 延迟聚焦到页面加载完成后
  监听WebView2的DocumentCompleted事件，在页面完全加载后再通过JS触发聚焦。示例代码：

  m_webView->add_DocumentCompleted(
      Callback<ICoreWebView2DocumentCompletedEventHandler>(
          [this](ICoreWebView2*, ICoreWebView2NavigationCompletedEventArgs*) -> HRESULT {
              m_webView->ExecuteScript(L"document.body.focus();", nullptr);
              return S_OK;
          }).Get(),
      &m_docCompletedToken);
  

• 验证WebView2初始化流程
  确保所有与页面交互的操作（包括聚焦）都在CoreWebView2初始化完成后执行。可通过CreateCoreWebView2Controller的回调函数确认初始化状态，再启动后续逻辑。

• 检查窗口消息循环
  排查主窗口的消息处理逻辑，确认未阻塞或拦截WM_SETFOCUS、WM_KILLFOCUS等焦点相关消息，避免影响WebView2控件的焦点获取流程。

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