WPF中WebView2 EnsureCoreWebView2Async无异常永不返回问题排查

按以下优先级逐步排查，覆盖所有已知会导致该问题的场景：

1. 验证WebView2运行时完整性 #

不要依赖在线引导程序的“已安装”提示判断运行时状态：

• 打开「程序和功能」面板，找到Microsoft Edge WebView2 Runtime，记录当前安装版本
• 完全卸载现有WebView2运行时，重启系统
• 下载对应系统架构的WebView2离线安装包重新安装，安装完成后再次确认版本匹配
• 企业域环境下，在线引导程序常因权限拦截出现“假安装”：注册表有安装记录，但核心运行时文件缺失或权限不足，离线安装包可规避该问题

2. 排查用户数据目录权限问题 #

WebView2初始化时需要在本地创建缓存目录，目录权限不足、被占用会直接导致初始化挂起且不抛出异常：

• 测试代码中显式指定可读写的自定义用户数据目录，不要使用默认路径，示例：

var webView2Env = await CoreWebView2Environment.CreateAsync(null, @"C:\Temp\wv2_test_cache");
await wv.EnsureCoreWebView2Async(webView2Env);

• 提前手动创建目标缓存文件夹，给当前登录用户赋予该文件夹完全控制权限后再运行测试程序
• 如果自定义路径下初始化正常，说明默认缓存路径（默认位于AppData\Local对应程序目录）存在权限锁定、磁盘损坏、安全软件拦截写入的问题

3. 排查第三方软件注入拦截 #

无异常的永久挂起绝大多数由第三方软件Hook WebView2进程创建逻辑导致：

• 执行干净启动测试：按Win+R输入msconfig，在「服务」页勾选「隐藏所有Microsoft服务」后点击全部禁用，再在任务管理器启动项页禁用所有启动项，重启系统后运行测试程序
• 重点排查三类软件：
  • 带浏览器防护、进程注入功能的安全软件、企业端点防护/审计工具
  • 带全局网页广告拦截、划词翻译、脚本注入功能的客户端工具
  • 各类系统优化、窗口管理类工具
• 可通过Process Monitor过滤测试程序、msedgewebview2.exe进程的操作日志，查找ACCESS DENIED类型的返回项定位拦截点

4. 修复系统组件损坏问题 #

系统组件损坏、Edge浏览器核心文件异常也会导致WebView2初始化卡住：

• 以管理员身份打开命令提示符，依次执行以下命令修复系统映像：

sfc /scannow
DISM /Online /Cleanup-Image /RestoreHealth

• 测试系统自带的Microsoft Edge浏览器是否能正常启动：如果Edge启动闪退、无响应，说明Edge与WebView2共用的核心组件损坏，在「程序和功能」中找到Microsoft Edge，右键选择「修改」-「修复」，完成后再测试

5. 代码层面增加兼容兜底 #

• 给初始化逻辑增加超时判断，避免程序永久无响应，示例：

var initTask = wv.EnsureCoreWebView2Async();
if (await Task.WhenAny(initTask, Task.Delay(TimeSpan.FromSeconds(15))) != initTask)
{
    MessageBox.Show("WebView2初始化超时，请检查运行时状态与安全软件拦截情况");
    return;
}

• 确认项目引用的WebView2 SDK版本不高于客户机器安装的WebView2 Runtime版本，跨大版本的SDK与Runtime不兼容也可能触发无响应问题

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