WebView2连续导航异常：文件URL导航被中止的问题与方案咨询

我有一个使用WebView2浏览器的C# WinForms应用，窗体包含网格组件和浏览器视图。当用户切换网格中的选中行时，程序会获取新数据并据此生成HTML文件，随后WebView2浏览器会导航至该文件URL以展示更新后的内容。

为解决数据获取与文件生成过程中存在延迟、导致浏览器短暂显示旧数据的问题，我添加了先导航至about:blank、再导航至目标文件URL的中间步骤。即每次行变更时会执行两次导航：

• 导航至about:blank
• 导航至生成的HTML文件

该方案在过去两年运行正常，但近期在部分环境中出现异常：两次导航（至about:blank和文件URL）几乎同时触发，导致文件URL的导航被中止，仅about:blank的导航成功。

我已通过NavigationStarting和NavigationCompleted事件及导航ID确认了该问题，原实现代码如下：

private void NavigateToBlankThenFileAsync()
{
    webView2.CoreWebView2.Navigate("about:blank");
    var fileUrl = GetHTMLDataAndWriteItIntoFile();
    webView2.CoreWebView2.Navigate(fileUrl);
}

为缓解该问题，我修改了逻辑，等待about:blank导航完成后再触发文件URL的导航，实现代码如下：

private TaskCompletionSource<bool> navigationCompletedTask;

// Call this function when you want to trigger navigation
private async Task NavigateToBlankThenFileAsync()
{
    navigationCompletedTask = new TaskCompletionSource<bool>();

    // Navigate to about:blank
    webView2.CoreWebView2.Navigate("about:blank");

    // Await navigation to about:blank before proceeding
    await navigationCompletedTask.Task;
    var fileUrl = GetHTMLDataAndWriteItIntoFile();
    // Now safe to navigate to actual file URL
    webView2.CoreWebView2.Navigate(fileUrl);
}

// Event handler for navigation completed
private void WebView2_NavigationCompleted(object sender, CoreWebView2NavigationCompletedEventArgs e)
{
    var uri = webView2.Source?.ToString();

    if (uri == "about:blank" && navigationCompletedTask != null)
    {
        navigationCompletedTask.SetResult(true);
        navigationCompletedTask = null;
    }
}

现咨询以下问题：

1. 该方案是否为确保WebView2可靠连续导航的正确方式？
2. 是否存在更优、更健壮的方法以避免文件URL的导航被中止？
3. 近期环境或WebView2更新中是否有已知的变更或配置导致该问题出现？

1. 现有方案的正确性 #

你的修改方案是正确且可靠的。WebView2的导航操作是异步执行的，旧代码中连续调用Navigate会导致后一次请求覆盖前一次未完成的导航（尤其是在about:blank导航还未完成时就触发文件URL导航）。通过TaskCompletionSource等待about:blank的NavigationCompleted事件，确保两次导航串行执行，从根本上避免了导航竞争的问题。

不过需要补充两个细节来提升健壮性：

• 处理导航失败的情况：在NavigationCompleted事件中，若e.IsSuccess为false，也需要完成TaskCompletionSource，避免程序陷入无限等待。
• 防止重复触发冲突：在创建新的TaskCompletionSource前，检查是否存在未完成的任务，若有则先取消或完成旧任务，避免多个导航请求互相干扰。

2. 更优的替代方案 #

推荐以下几种更简洁高效的方法：

• 直接使用NavigateToString跳过文件生成：不需要生成本地HTML文件，直接将生成的HTML字符串传递给WebView2，完全避免文件IO延迟和导航竞争。示例代码：

private async void OnGridRowSelectedChanged(object sender, EventArgs e)
{
    // 直接生成HTML字符串，无需写入文件
    string htmlContent = GenerateHTMLFromSelectedRowData();
    await webView2.CoreWebView2.NavigateToStringAsync(htmlContent);
}

这种方法不仅省去了文件读写的开销，还彻底消除了两次导航的必要，是最优解。

• 使用加载占位符替代about:blank：在生成HTML的过程中，先通过NavigateToString显示加载提示（如<div>加载中...</div>），等HTML文件生成完成后再导航到目标文件，既避免旧数据显示，又提升用户体验。

• 利用导航事件串行化请求：如果必须保留文件方式，可以在NavigationStarting事件中控制导航顺序，确保只有前一次导航完成后才允许新的导航请求，但这种方式复杂度高于现有方案。

3. 导致问题的环境/版本变更 #

近期WebView2运行时的更新（基于Chromium 110+版本）调整了连续导航的处理逻辑：当快速触发多次Navigate请求时，WebView2会取消之前未完成的导航，优先处理最新的请求。而旧版本的WebView2可能会排队处理导航请求，因此你的原方案在之前能正常运行，现在出现了覆盖问题。

此外，部分环境中的WebView2配置（如启用快速导航优化、硬件加速设置）也可能影响导航的执行顺序，加剧了这个问题的出现。

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