CoreWebView2Environment.CreateAsync缓存行为问题咨询

问题复现过程 #

开发WPF应用时，在可执行文件同级目录部署了版本号为101.0.1210.47的固定版自定义WebView2运行时，为复现用户反馈问题开展了两组验证实验：

• 实验1：删除运行时目录下的msedgewebview2.exe后启动应用，执行env = CoreWebView2Environment.CreateAsync(browserExecutableFolder, EnvHelper.AppLocalFolder).Result;时运行成功，但后续执行await WebView.EnsureCoreWebView2Async(env);时抛出预期异常：

  System.IO.FileNotFoundException: The system cannot find the file specified. (Exception from HRESULT: 0x80070002)
  

• 实验2：不重启应用，手动将msedgewebview2.exe恢复到browserExecutableFolder指向的路径（调试环境下路径为C:\repo\App\bin\x64\Debug\WebView2），重新执行上述相同初始化逻辑，即便msedgewebview2.exe已存在，仍抛出相同的文件找不到异常。

已尝试的修复手段均未生效：
每次调用CoreWebView2Environment.CreateAsync(browserExecutableFolder, EnvHelper.AppLocalFolder)时传入不同的EnvHelper.AppLocalFolder参数，甚至调整代码为如下逻辑，问题依旧存在：

Environment.SetEnvironmentVariable("WEBVIEW2_BROWSER_EXECUTABLE_FOLDER", @"C:\repo\App\bin\x64\Debug\WebView2");
coreWebView2Environment = await CoreWebView2Environment.CreateAsync(browserExecutableFolder, EnvHelper.AppLocalFolder, new CoreWebView2EnvironmentOptions(null, null, "101.0.1210.47"));

核心疑问 #

• 该现象是否说明WebView2运行时会在首次调用CoreWebView2Environment.CreateAsync后缓存运行时文件的存在性检测结果？
• 若首次调用时文件缺失，后续调用是否不会重新执行检测？
• 是否有方法可以禁用该首次调用结果的缓存机制，让每次调用CreateAsync时都重新执行有效性检测？

解答 #

该缓存行为确实存在，但缓存层级不在CoreWebView2Environment.CreateAsync方法本身，而是WebView2原生核心模块的进程级全局缓存，具体逻辑如下：

1. CoreWebView2Environment.CreateAsync执行阶段仅做参数合法性校验、路径格式校验，不会触发完整的运行时文件完整性检测，真正的运行时加载、文件存在性校验是在首次调用EnsureCoreWebView2Async、触发WebView2浏览器进程启动时才会执行。
2. 首次检测到传入的固定版运行时路径下核心文件缺失后，WebView2原生模块会在当前宿主进程的内存中标记该运行时路径为无效状态。后续即使磁盘上的文件已经恢复，只要当前宿主进程不重启，该无效标记不会自动清除，无论传入什么用户数据文件夹参数、环境变量、指定版本号，都会直接返回之前记录的文件找不到错误，不会重新扫描磁盘做文件有效性校验。
3. WebView2官方没有提供公开API用于禁用该进程级缓存，也没有提供接口手动重置该无效路径标记。

可落地的规避方案如下：

• 前置校验方案：在调用EnsureCoreWebView2Async之前，自行在托管代码层做预检查，手动验证browserExecutableFolder路径下msedgewebview2.exe等核心文件是否存在，若文件缺失直接抛出友好提示，引导用户修复运行时文件后重启应用，不要在文件缺失的状态下触发WebView2初始化流程，避免触发无效路径缓存。
• 进程隔离方案：如果需要支持不重启主应用即可恢复运行时的场景，将所有WebView2相关逻辑拆分到独立的辅助进程中承载。当检测到运行时文件缺失、用户完成修复后，直接销毁旧的辅助进程，启动新的辅助进程重新加载WebView2即可——由于缓存是进程级的，新启动的进程会重新执行完整的文件有效性检测，不会受之前失败记录的影响。
• 运行时选型优化：如果没有强绑定固定版本的需求，优先使用机器全局安装的共享版WebView2运行时，共享版运行时由官方更新组件维护完整性，不会出现单文件意外缺失的问题，整体稳定性更高。

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