WPF调试时WebView2正常，经vdproj安装后失效及初始化超时

• 处理原生依赖文件WebView2Loader.dll
  • vdproj安装项目默认不会自动识别NuGet包提供的多架构runtimes目录下的原生文件，需要手动将与项目目标架构匹配的WebView2Loader.dll添加到安装包的主程序同级目录：x86架构项目对应添加runtimes\win-x86\native\WebView2Loader.dll，x64架构项目对应添加runtimes\win-x64\native\WebView2Loader.dll，禁止混放不同架构的同名文件。
  • 不要将整个runtimes文件夹打包进安装包，仅保留运行所需的架构匹配的DLL文件即可，避免安装后目录结构混乱。
• 禁止打包静态生成的WebView2用户缓存目录
  • 本地调试时生成的iGo360UtilitySettingWPF.exe.WebView2是WebView2运行时自动生成的缓存目录，属于动态生成内容，不是静态依赖。将这个目录打包进安装包，会因为权限限制、缓存锁残留直接触发运行异常，正确逻辑是由程序在首次启动时根据当前用户权限自动创建对应缓存目录。
• 补充安装项目配置项
  • 在安装项目的启动条件中，增加对目标机器WebView2 Runtime版本的检测，确保部署环境的Runtime版本不低于项目依赖的90.0.818.42，避免版本不兼容触发问题。
  • 安装时不要对主程序目录设置严格的写入限制，同时配合代码逻辑将可写的动态缓存目录移出受系统保护的Program Files路径。

该错误为操作超时类COM异常，不存在复杂的代码逻辑问题，核心触发原因集中在三点：

1. 手动拷贝的本地调试WebView2缓存目录中残留了旧的进程锁文件、损坏的缓存内容，部署到受权限保护的安装目录后，程序没有权限删除锁文件，导致WebView2环境创建时一直等待锁释放，最终超时。
2. 代码指定的用户数据目录路径位于Program Files这类受系统保护的安装路径下，普通用户没有该路径的写入权限，WebView2无法创建缓存子目录、写入进程配置文件，反复重试触发超时。
3. 90版本的WebView2存在已知兼容问题：当WebView2控件还未完成视觉句柄初始化时就调用EnsureCoreWebView2Async，会导致初始化流程一直等待，最终触发超时。

• 修正用户数据目录路径配置
  • 不要将WebView2用户数据目录放在程序安装路径下，按照WebView2的运行要求，将缓存目录指向当前用户的LocalAppData独立子目录，示例路径为Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "iGo360UtilitySettingWPF", "WebView2Cache")，该路径默认对当前用户开放完全读写权限，不会触发权限拦截。
  • 在调用CoreWebView2Environment.CreateAsync前，先手动判断目标缓存目录是否存在，不存在的话调用Directory.CreateDirectory创建，不要完全依赖WebView2自动创建目录。
• 解决缓存锁冲突问题
  • 部署安装包时彻底移除之前手动拷贝的WebView2缓存目录，不要将调试环境的动态内容打包进安装包。
  • 初始化逻辑中增加容错处理：第一次初始化超时后，清理缓存目录下的锁文件，重试一次初始化流程，解决偶发的进程残留锁占用问题。
• 调整初始化时机
  • 不要直接在Window_Loaded事件中触发初始化，将初始化逻辑挂载到WebView2控件自身的Loaded事件上，确保控件已经完成句柄创建后再调用EnsureCoreWebView2Async，避免90版本WebView2的句柄等待超时问题。
• 常见环境排查项
  • 检查企业环境的组策略配置，确认没有策略项拦截msedgewebview2.exe进程的启动，部分企业管控策略会直接阻断WebView2进程拉起，导致初始化超时。
  • 确认项目主程序的目标架构和WebView2Loader.dll的架构完全匹配，架构不匹配会因为系统隔离机制导致进程加载超时。

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