C# WebView2打包为MSI后无法运行，ClickOnce发布正常求解决

以下是我编写的C# WinForms代码：

using System;
using System.Windows.Forms;

namespace Test
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
             Load += Form1_Load;
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            this.webView21.Source = new Uri("https://www.google.com");
        }
    }
}

使用ClickOnce发布时WebView2可正常运行，但打包成MSI文件后WebView2无法工作，该如何解决？

1. 确认WebView2 Runtime部署 #

WebView2运行依赖WebView2 Runtime，ClickOnce会自动处理部分依赖，但MSI打包需要手动配置：

• 若选择常青版Runtime：可在MSI安装程序中添加检测逻辑，若用户未安装则引导其完成安装；
• 若选择固定版本Runtime：将对应的Runtime文件（可从NuGet包的runtimes目录获取）添加到MSI安装项目中，随程序一同部署到目标机器。

2. 完善项目依赖与打包配置 #

• 打开NuGet包管理器，确保已安装Microsoft.Web.WebView2最新稳定版；
• 若使用Visual Studio Installer Projects制作MSI：
  • 将主项目的输出添加到安装项目；
  • 检查WebView2相关依赖文件（如WebView2Loader.dll）是否被包含在安装文件列表中，若未自动添加，手动从项目输出目录将这些文件添加到安装项目。

3. 添加初始化错误处理与显式环境配置 #

原代码未显式初始化WebView2环境，容易忽略运行时错误，修改代码如下：

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

namespace Test
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            Load += Form1_Load;
        }

        private async void Form1_Load(object sender, EventArgs e)
        {
            try
            {
                // 设置用户专属目录作为WebView2缓存路径，避免系统目录权限问题
                var userCachePath = Path.Combine(
                    Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
                    "TestAppWebView2Cache"
                );
                // 显式创建WebView2运行环境
                var webViewEnv = await CoreWebView2Environment.CreateAsync(null, userCachePath);
                // 初始化WebView2控件
                await webView21.EnsureCoreWebView2Async(webViewEnv);
                
                webView21.Source = new Uri("https://www.google.com");
            }
            catch (Exception ex)
            {
                MessageBox.Show($"WebView2初始化失败：{ex.Message}\n{ex.StackTrace}");
            }
        }
    }
}

这段代码会捕获初始化错误，同时将缓存路径设置到用户可读写的目录，避免程序安装在系统目录时的权限限制。

4. 检查安装目录权限 #

尽量避免将MSI安装到需要管理员权限的目录（如C:\Program Files），若必须安装到此类目录，需在MSI中配置程序运行时的权限，或确保WebView2的缓存和数据目录指向用户可读写的路径。

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