解决 WebView2 中 HostObject 调用窗体关闭时的 InvalidCastException 与线程问题

在使用 Microsoft Edge WebView2 构建 WPF 桌面应用时，我们经常需要从网页 JavaScript 中调用 .NET 方法——例如点击网页按钮后关闭当前窗口。这通常通过 AddHostObjectToScript 注入一个 [ComVisible] 的 .NET 对象（称为 HostObject）来实现。

然而，许多开发者会遇到如下异常：

System.InvalidCastException: 无法将类型为'System.__ComObject'的 COM 对象强制转换为接口类型 'Microsoft.Web.WebView2.Core.Raw.ICoreWebView2Controller'。此操作失败的原因是对 IID 为'{4D00C0D1-9434-4EB6-8078-8697A560334F}'的接口的 COM 组件调用 QueryInterface 因以下错误而失败：不支持此接口 (异常来自 HRESULT:0x80004002 (E_NOINTERFACE))。

更棘手的是，即使绕过该异常，在 HostObject 中直接调用 Window.Close() 也可能导致线程访问异常或无响应。

本文将深入剖析这两个问题，并提供安全、可靠、符合最佳实践的完整解决方案。

一、问题根源分析

1. InvalidCastException：COM 接口不支持

该错误的核心是：

WebView2 SDK 版本 > 运行时（Runtime）版本

当你使用较新的 Microsoft.Web.WebView2 NuGet 包（如 v1.0.2700+），但目标机器上的 WebView2 Runtime（或 Edge 浏览器）版本较旧时，某些新定义的 COM 接口（如 ICoreWebView2Controller）在旧运行时中并不存在。此时尝试强制转换就会触发 E_NOINTERFACE 错误。

⚠️ 注意：不要手动引用 Microsoft.Web.WebView2.Core.Raw 命名空间中的接口，这些是内部实现，不应由应用代码直接使用。

2. HostObject 中关闭窗体失败：跨线程访问 UI

HostObject 的方法是从 WebView2 渲染线程（非 UI 线程） 调用的，而 WPF 的 Window 对象只能在创建它的 STA UI 线程 上访问。直接调用 window.Close() 会抛出：

System.InvalidOperationException: The calling thread cannot access this object...

二、解决方案

✅ 步骤 1：确保 WebView2 环境兼容

确保用户安装最新 WebView2 Runtime
- 引导用户访问 https://developer.microsoft.com/en-us/microsoft-edge/webview2/ 安装 Evergreen Bootstrapper。
- 或检查 Edge 浏览器是否为最新版（WebView2 随 Edge 自动更新）。
避免使用 Raw 接口 所有操作应通过 Microsoft.Web.WebView2.Wpf.WebView2 公开的属性（如 CoreWebView2）完成，切勿强制转换 __ComObject。

升级 NuGet 包 在 .csproj 中使用最新稳定版：

<PackageReference Include="Microsoft.Web.WebView2" Version="1.0.2739.17" />

✅ 步骤 2：正确从 HostObject 关闭 WPF 窗口

1. 定义安全的 HostObject 类

using System.Runtime.InteropServices;
using System.Windows;

[ComVisible(true)]
public class ScriptHost
{
    private readonly Window _window;

    public ScriptHost(Window window)
    {
        _window = window ?? throw new ArgumentNullException(nameof(window));
    }

    public void CloseWindow()
    {
        // 必须切换回 UI 线程
        _window.Dispatcher.Invoke(() =>
        {
            if (_window.IsLoaded) // 可选：确保窗口仍有效
                _window.Close();
        });
    }
}

2. 在 WPF 窗口中注册 HostObject

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
        Loaded += OnLoaded;
    }

    private async void OnLoaded(object sender, RoutedEventArgs e)
    {
        // 确保 CoreWebView2 已初始化
        await webView.EnsureCoreWebView2Async(null);
        // 注入 HostObject
        webView.CoreWebView2.AddHostObjectToScript("host", new ScriptHost(this));
    }
}

3. JavaScript 调用方式

// 在网页中
window.chrome.webview.hostObjects.options.forceAsyncMethodCalls = true;
window.chrome.webview.hostObjects.host.CloseWindow();

💡 提示：启用 forceAsyncMethodCalls 可避免同步调用阻塞渲染线程。

✅ 补充技巧：从任意控件获取所在 Window

如果你的逻辑封装在 UserControl 中，可使用 WPF 内置方法获取宿主窗口：

Window parentWindow = Window.GetWindow(this);

适用于已加载到可视化树的控件。
若返回 null，说明控件尚未加入窗口（如在构造函数中调用）。

三、最佳实践总结

问题	建议
COM 转换异常	升级 Runtime + 避免使用 `Raw` 接口
跨线程关闭窗口	使用 `Dispatcher.Invoke` 切回 UI 线程
HostObject 设计	保持简单、无状态、仅暴露必要方法
安全性	不要暴露整个窗体对象，只提供 `CloseWindow()` 等受控接口

四、结语

WebView2 是构建现代混合桌面应用的强大工具，但其基于 COM 的架构和多线程模型要求开发者格外注意版本兼容性与线程安全。通过本文的方法，你可以安全地从网页控制 WPF 窗口行为，同时避免常见的陷阱。

📌 记住：HostObject ≠ UI 控件，它是独立的 COM 可见对象；所有 UI 操作必须回到 Dispatcher 线程；保持 WebView2 SDK 与 Runtime 同步更新。

参考链接：