如何在WiX Toolset中为MsiPackage的DownloadUrl添加HTTP请求头

原生WiX Burn引擎的MsiPackage元素没有提供原生配置项，支持直接为DownloadUrl触发的HTTP下载请求添加自定义请求头，引擎默认发起请求时仅携带标准HTTP头字段，未暴露直接修改请求头的配置入口。你当前使用的配置写法无法实现自定义请求头需求：

<MsiPackage
    SourceFile="path/to/file.msi"
    DownloadUrl="url/to/file.msi"
    Compressed="no" 
      >
</MsiPackage>

可行实现路径 #

方案1：自定义引导程序接管下载逻辑（推荐） #

这是官方支持的标准扩展方式，不会破坏安装包签名和流程完整性：

• 调整包配置：移除MsiPackage上的DownloadUrl属性，保留Compressed="no"配置，标记该包需要外部提供本地源
• 在自定义Bootstrapper Application（引导程序层）自行实现HTTP下载逻辑，这部分代码完全可控，可以自由添加任意自定义请求头、鉴权参数、下载进度回调、重试逻辑
• 下载完成校验文件哈希无误后，通过引擎提供的SetLocalSource接口将MSI的本地存储路径传给Burn引擎，引擎会直接使用本地文件执行后续安装流程，不会再发起远程下载请求
• 自定义下载核心代码示例（基于C#托管引导程序）：

// 初始化HTTP客户端，添加自定义请求头
using var httpClient = new HttpClient();
httpClient.DefaultRequestHeaders.Add("X-Your-Custom-Header", "header-value-here");
// 执行下载
var installPath = Path.Combine(Path.GetTempPath(), "your-installer.msi");
await using var stream = await httpClient.GetStreamAsync("your-real-msi-download-url");
await using var fileStream = new FileStream(installPath, FileMode.Create);
await stream.CopyToAsync(fileStream);
// 将本地路径同步给Burn引擎
engine.SetLocalSource("YourMsiPackageId", installPath);

方案2：安装流程启动前预下载 #

如果不需要在安装引导流程中动态触发下载，可以在引导程序刚启动、Burn引擎开始执行包检测逻辑之前，就自行发起带自定义请求头的HTTP请求下载MSI文件，将文件放到Burn引擎默认查找本地缓存的路径下，引擎检测到本地文件存在时会直接使用，不会触发远程下载。

注意：不要通过逆向修改Burn引擎二进制、Hook系统网络请求的方式篡改默认下载逻辑，这类操作会破坏安装包的数字签名，触发Windows SmartScreen安全拦截，也可能导致安装流程的回滚、修复、卸载逻辑异常。

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