VB WinForms WebView2 Xcopy部署后“文件未找到”异常求助

核心原因 #

问题本质是WebView2依赖的Edge WebView2 Runtime或组件文件未在目标机器上正确部署：开发机因VS/Edge附带安装了Runtime，而Xcopy部署默认不会自动包含Runtime组件，导致EnsureCoreWebView2Async调用时找不到依赖文件。

具体排查与修复步骤 #

1. 验证目标机器的WebView2 Runtime版本 #

你的NuGet包版本1.0.1774.30对应Runtime版本为116.0.1938.69。

• 检查目标机器是否安装了该版本Runtime：通过控制面板→程序和功能查看；
• 未安装的话，有两种方案：
  • 让用户手动下载安装对应版本的Runtime；
  • 采用固定版本部署：下载对应Runtime包，解压到应用目录，随程序一起Xcopy分发。

2. 检查NuGet包的本地复制配置 #

确保WebView2相关组件被复制到输出目录：

• 在项目中，右键Microsoft.Web.WebView2 NuGet包→属性，将Copy Local设为True；
• 确认输出目录下存在runtimes文件夹，里面包含对应平台（x86/x64）的Microsoft.Web.WebView2.Core.dll等文件。

3. 显式指定Runtime路径（固定版本部署时用） #

如果打包了Runtime到应用目录，可提前创建环境对象，避免依赖系统Runtime：

Try
    Dim runtimePath As String = Path.Combine(Application.StartupPath, "WebView2Runtime")
    Dim env = Await CoreWebView2Environment.CreateAsync(runtimePath)
    Await WebView.EnsureCoreWebView2Async(env)
Catch ex As Exception
    MessageBox.Show($"错误详情：{ex.Message}{vbCrLf}内部错误：{ex.InnerException?.Message}")
End Try

• 需将解压后的Runtime文件放在应用根目录的WebView2Runtime文件夹中，确保包含msedgewebview2.exe。

4. 捕获完整异常信息 #

原异常仅提示“文件未找到”，修改代码捕获内层异常，定位具体缺失文件：

Try
    Await WebView.EnsureCoreWebView2Async(Nothing)
Catch ex As Exception
    Dim errorMsg As New StringBuilder()
    errorMsg.AppendLine($"错误：{ex.Message}")
    Dim innerEx = ex.InnerException
    While innerEx IsNot Nothing
        errorMsg.AppendLine($"内层错误：{innerEx.Message}")
        innerEx = innerEx.InnerException
    End While
    MessageBox.Show(errorMsg.ToString())
End Try

5. 排查权限问题 #

部分机器因UAC限制，应用无法读取部署目录文件，会伪装成“文件未找到”：

• 尝试以管理员身份运行应用；
• 确保部署目录有读写权限（尤其是AppData下的WebView2缓存目录，但通常Xcopy部署到普通目录即可）。

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