WebView2发布到其他电脑仅显示白窗无法加载网页如何解决

核心原因 #

• 开发设备安装Visual Studio 2019时默认附带了WebView2运行时，所以本地运行正常，但目标设备仅安装了.NET桌面运行时，缺少WebView2运行时依赖，这是最常见的诱因
• WebView2初始化默认需要写入用户数据目录，若程序放在需要高权限的目录（如Program Files）下，普通用户权限无法写入会导致初始化失败
• 发布配置有误，未将WebView2的NuGet依赖完整打包到发布文件夹中，或发布架构与目标设备架构不匹配
• 目标设备网络受限，无法访问代码中指定的网页地址

解决步骤 #

1. 安装WebView2运行时
   在目标设备上安装对应架构的Microsoft Edge WebView2 Runtime，该组件是WebView2程序运行的必备依赖，不包含在.NET桌面运行时中。

2. 调整发布配置

• 打开项目的NuGet包管理器，确认Microsoft.Web.WebView2包已正确安装，右键该包设置「复制本地」属性为True
• 发布时选择与目标设备匹配的架构（x86/x64/ARM64），若需要兼容多种设备可选择Any CPU模式

3. 新增用户数据目录配置，避免权限问题
   在设置WebView2的Source属性前，显式指定具备读写权限的用户数据存储目录，参考代码如下：

Imports Microsoft.Web.WebView2.Core
Imports System.IO

' 初始化前先配置存储路径，路径名替换为你的程序自定义名称
Dim userDataPath As String = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "你的程序自定义名称")
Await WebBrowser.EnsureCoreWebView2Async(Nothing, CoreWebView2Environment.CreateAsync(Nothing, userDataPath).Result)

' 再设置目标地址
Dim filePath1 As String = "https://stackoverflow.com/"
WebBrowser.Source = New Uri(filePath1)

4. 网络校验
   确认目标设备可正常访问代码中指定的网页地址，排除防火墙、代理、网络策略拦截的情况。

排查技巧 #

可监听CoreWebView2InitializationCompleted和NavigationCompleted事件，捕获初始化或页面加载过程的错误码，快速定位具体问题。

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