C#安装项目配置WebView2 Runtime依赖后已安装仍检测缺失问题求助

常见遗漏配置及修复方案 #

• 注册表搜索覆盖不全
  WebView2 运行时的注册表标识根据安装位宽、安装范围有多个路径，只配置单个路径会出现漏检：
  • 全局安装64位运行时路径：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
  • 全局安装32位运行时（64位系统下重定向路径）：HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
  • 当前用户安装的运行时路径：HKEY_CURRENT_USER\SOFTWARE\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}
    建议同时添加上述三类路径的搜索逻辑，避免位宽、安装范围差异导致的检测失败。
• 启动条件配置错误
  1. 确认你设置的最低运行时版本号，低于等于目标机已安装的 WebView2 Runtime 版本
  2. 检查启动条件的逻辑判断是否正确，应为你定义的运行时版本变量 >= 最低要求版本，避免写反判断逻辑
  3. 确认注册表搜索中定义的属性名，和启动条件中引用的属性名完全一致，大小写拼写错误也会导致检测失效
• 运行时渠道不匹配
  默认的检测逻辑只识别正式发布的 WebView2 Runtime，若目标机安装的是 Edge 浏览器预览版（Canary/Dev/Beta）渠道自带的运行时，会触发未检测到的提示，需要额外添加对应渠道的注册表搜索项才可兼容。

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