.NET 6 WPF应用部署后WebView2无法初始化问题求助

问题根源 #

1. 缺失WebView2 Runtime：开发机通常因安装Edge或开发工具自带该运行时，但部署机器仅装.NET 6 Runtime不足以支撑WebView2运行，二者是独立依赖。
2. 异步逻辑错误：原代码用GetAwaiter().OnCompleted()的方式未正确等待CoreWebView2初始化完成，就执行导航操作；且错误使用NavigateToString传入网址（该方法用于加载HTML字符串，而非URL）。
3. 缓存目录权限问题：指定的another_dir可能无读写权限，导致WebView2无法创建必要的缓存文件，初始化失败。

修复方案 #

1. 部署WebView2 Runtime #

WebView2必须依赖对应Runtime才能运行，两种部署方式可选：

• Evergreen Runtime：让用户安装微软官方的Evergreen Bootstrapper，会自动保持Runtime更新，适合大多数场景。
• Fixed Version Runtime：将固定版本的Runtime与应用打包，无需用户额外安装。可通过NuGet包Microsoft.Web.WebView2的FixedVersionRuntimeFiles配置，打包时将Runtime文件包含到输出目录。

2. 修正初始化代码 #

重构异步逻辑，确保等待CoreWebView2初始化完成后再执行导航，并使用正确的导航方法：

public MainWindow()
{
    InitializeComponent();
    _ = InitializeWebView2(); // 用_规避异步方法无等待的警告
}

private async Task InitializeWebView2()
{
    try
    {
        // 创建应用专属的缓存目录，确保当前用户有读写权限
        var cacheDir = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
            "YourAppName",
            "WebViewCache"
        );
        Directory.CreateDirectory(cacheDir); // 确保目录存在

        // 创建WebView2环境
        var env = await CoreWebView2Environment.CreateAsync(null, cacheDir);
        
        // 实例化WebView2并添加到面板
        var webview = new WebView2();
        myPanel.Children.Add(webview);

        // 等待CoreWebView2初始化完成
        await webview.EnsureCoreWebView2Async(env);

        // 正确导航到目标网址（使用Source属性或Navigate方法）
        webview.Source = new Uri("https://google.com");
    }
    catch (Exception e)
    {
        // 部署环境建议用MessageBox展示错误，方便排查
        MessageBox.Show($"WebView2初始化失败：{e.Message}\n{e.StackTrace}");
        Console.WriteLine(e);
    }
}

3. 权限与路径检查 #

• 避免使用相对路径或系统受限目录（如C盘根目录）作为缓存目录，优先使用LocalApplicationData这类系统分配的应用专属目录。
• 确认应用运行时的用户对缓存目录拥有读写权限。

额外排查手段 #

• 查看目标机器的事件查看器，筛选WebView2相关错误日志，定位具体失败原因。
• 在目标机器上手动启动Edge浏览器，验证WebView2 Runtime是否正常工作。

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