WinUI3非打包程序在C:\Program Files中WebView2加载失败求助

1. 指定WebView2用户数据文件夹到有权限的位置 #

WebView2默认会在程序所在目录创建用户数据文件夹，而C:\Program Files是系统受写保护目录，无法创建或写入数据，直接导致WebView2加载失败。你需要手动将用户数据目录指定到当前用户可读写的路径，比如%LOCALAPPDATA%\你的程序标识：

在WebView2控件初始化阶段添加以下代码：

using Microsoft.Web.WebView2.Core;
using System.IO;
using System;

// 在窗口加载或WebView2初始化前执行
var userDataFolder = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "你的程序唯一标识");
var env = await CoreWebView2Environment.CreateAsync(null, userDataFolder);
await webView2Control.EnsureCoreWebView2Async(env);

确保路径是当前用户拥有完全读写权限的目录，避开系统保护区域。

2. 处理WebView2运行时部署 #

框架依赖型程序不会自动包含WebView2运行时，即便你打包了Windows SDK也无法覆盖这个组件：

• 若面向内部用户，可要求提前安装WebView2 Evergreen Bootstrapper；
• 若要离线分发，下载对应架构（x64/x86/arm64）的WebView2 Fixed Version Runtime，将运行时文件打包到程序目录的WebView2Runtime子文件夹，然后初始化时指定运行时路径：

var runtimeFolder = Path.Combine(AppContext.BaseDirectory, "WebView2Runtime");
var userDataFolder = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "你的程序唯一标识");
var env = await CoreWebView2Environment.CreateAsync(runtimeFolder, userDataFolder);
await webView2Control.EnsureCoreWebView2Async(env);

3. 调整文件存储路径 #

避免在C:\Program Files目录下进行读写操作：

• 下载的PDF文件不要存到程序目录，改为存到%USERPROFILE%\Downloads或用户专属的文档文件夹；
• 程序配置信息改用ApplicationData.Current.LocalSettings存储，或写入注册表的HKEY_CURRENT_USER hive，不要直接写入程序所在目录。

4. 开启日志定位具体错误 #

如果以上步骤仍未解决问题，可开启WebView2调试日志排查根因：

var options = new CoreWebView2EnvironmentOptions();
options.AdditionalBrowserArguments = "--log-level=verbose";
var userDataFolder = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "你的程序唯一标识");
var env = await CoreWebView2Environment.CreateAsync(null, userDataFolder, options);
await webView2Control.EnsureCoreWebView2Async(env);

日志会生成在用户数据文件夹的WebView2\Log目录下，可从中找到加载失败的具体触发点（如权限不足、运行时文件缺失等）。

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