WinForms项目WebView2安装后无法加载URL问题求助

1. 确认WebView2运行时部署情况 #

Win11默认不一定包含适配项目的WebView2运行时，这是部署后空白的常见原因：

• 检查目标机器是否安装WebView2运行时，可通过控制面板程序列表查看。
• 两种部署方案二选一：
  • 打包固定版本运行时：在项目NuGet中设置Microsoft.Web.WebView2的部署模式为FixedVersion，将NuGet包runtimes目录下对应x64的运行时文件，随安装程序部署到程序目录。
  • 引导安装常青版：程序启动时检测运行时是否存在，若缺失提示用户下载安装常青版运行时。

2. 验证URL的有效性与访问权限 #

• 新增日志输出Common.GetConfig获取的URL，检查是否为空、格式错误（如缺少http/https前缀），或目标机器无法访问该地址（比如内网资源、本地文件路径错误）。
• 若加载本地文件，需确保路径为绝对路径且格式正确（例如file:///C:/xxx/xxx.html），同时安装程序已将文件部署到对应位置，程序拥有读取权限。

3. 确保WebView2完成初始化再加载URL #

WebView2未完成初始化就设置Source会导致加载失败，需先等待初始化完成：

private async void Form_Load(object sender, EventArgs e)
{
    await webView21.EnsureCoreWebView2Async();
    string url = Common.GetConfig(Common.sEnv, "txtExampleImages");
    webView21.Source = new Uri(url);
}

4. 检查部署文件完整性 #

• 确认安装程序已打包WebView2相关依赖文件，比如Microsoft.Web.WebView2.dll及对应的x64运行时文件。
• 验证项目输出目录中的WebView2相关文件，都被正确部署到目标机器的可执行文件夹下。

5. 通过日志排查具体错误 #

添加日志记录WebView2的初始化和导航错误，定位问题根源：

webView21.CoreWebView2InitializationCompleted += (s, args) =>
{
    if (args.IsSuccess)
    {
        webView21.CoreWebView2.NavigationCompleted += (sender, navArgs) =>
        {
            if (!navArgs.IsSuccess)
            {
                File.WriteAllText("webview_nav_error.log", $"导航失败: {navArgs.WebErrorStatus}");
            }
        };
    }
    else
    {
        File.WriteAllText("webview_init_error.log", $"初始化失败: {args.InitializationException.Message}");
    }
};

部署后运行程序，查看生成的日志文件获取具体错误信息。

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