Visual Studio 2019中WebView2控件添加异常求助

• 对比项目文件底层配置
  直接打开两个项目的.csproj（或.vbproj）文件对比：

  • 检查是否都使用PackageReference方式引用Microsoft.Web.WebView2，现有项目可能残留旧的Reference引用（比如直接引用本地DLL）导致冲突；
  • 确认项目的平台目标（x86/x64/AnyCPU）是否一致，WebView2对平台架构有要求，AnyCPU模式下可能需要设置“首选32位”；
  • 查看目标框架版本是否匹配，比如新项目是.NET 6而现有项目是.NET Framework 4.7.2，两者的WebView2配置逻辑有差异。

• 检查完整依赖树
  使用命令行工具查看两个项目的依赖详情：

  dotnet list package --include-transitive
  

  对比间接依赖的版本，比如Microsoft.Web.WebView2.Core、Microsoft.Web.WebView2.WinForms（或WPF）的版本是否完全一致，避免间接依赖版本冲突。

• 验证运行时文件与环境

  • 查看现有项目的输出目录（bin/Debug/xxx），确认是否包含WebView2相关运行时文件（如WebView2Loader.dll、Microsoft.Web.WebView2.Core.dll等），若缺失，检查项目中对应引用的“复制本地”属性是否设为True；
  • 检查运行环境的Edge WebView2 Runtime版本，确保其版本不低于NuGet包要求的最低版本，可通过edge://version查看当前Runtime版本。

• 排查控件初始化逻辑

  • 对比新项目和现有项目的WebView2初始化代码：
    • 确认是否正确订阅CoreWebView2InitializationCompleted事件，或使用EnsureCoreWebView2Async方法完成初始化；
    • 检查是否在初始化完成前就设置了Source属性，这会导致控件加载失败；
    • 给初始化代码添加try-catch块，捕获并打印异常信息，或查看VS输出窗口的调试日志，定位具体错误。

• 清理重建与缓存重置

  • 删除现有项目的bin、obj目录，清空本地NuGet缓存（可通过dotnet nuget locals all --clear命令），重新安装NuGet包；
  • 使用VS的“项目”→“管理NuGet程序包”→“已安装”→“Microsoft.Web.WebView2”→“更新/修复”功能，强制同步依赖。

• 检查项目类型与特殊配置

  • 确认现有项目是否为类库、插件项目等非直接运行的项目类型，这类项目可能需要额外配置才能正确加载WebView2控件；
  • 查看现有项目的app.config（或appsettings.json），是否存在影响WebView2加载的配置项，比如代理设置、Runtime路径指定等。

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