WPF使用WebView2加载HTML时CoreWebView2返回null空引用错误求解

开发者阿泽

2026-10-8

错误原因

WebView2组件的CoreWebView2对象初始化是异步流程，你在窗体构造函数中直接访问该属性时，初始化还未完成，因此返回null触发空引用异常。
直接传入本地文件系统路径调用Navigate不符合方法参数规范，需要先转为标准URI格式。

解决方法

方案1（最简实现，无需监听事件）

直接使用WebView2封装好的Source属性赋值，组件会自动等待初始化完成后加载目标地址，修改构造函数代码如下：

public MainWindow()
{
    InitializeComponent();
    // 用Path.Combine拼接路径，避免硬编码分隔符导致的兼容性问题
    string htmlPath = Path.Combine(Directory.GetCurrentDirectory(), "site", "index1.html");
    // 直接给Source属性赋值即可，无需手动操作CoreWebView2
    webContainer.Source = new Uri(htmlPath);
}

方案2（需要自定义初始化逻辑时使用）

如果你需要在CoreWebView2初始化完成后做额外配置，可以监听初始化完成事件后再执行操作：

public MainWindow()
{
    InitializeComponent();
    // 监听初始化完成事件
    webContainer.CoreWebView2InitializationCompleted += WebContainer_CoreWebView2InitializationCompleted;
}

private void WebContainer_CoreWebView2InitializationCompleted(object sender, Microsoft.Web.WebView2.Core.CoreWebView2InitializationCompletedEventArgs e)
{
    if (e.IsSuccess)
    {
        string htmlPath = Path.Combine(Directory.GetCurrentDirectory(), "site", "index1.html");
        webContainer.CoreWebView2.Navigate(new Uri(htmlPath).AbsoluteUri);
    }
}