通过HTTPS使用.appinstaller文件旁加载应用出现解析错误如何解决

第一步：先解决本地运行.appinstaller报无效的问题 #

本地直接运行就报错，说明文件本身存在格式或内容不匹配问题，按以下顺序排查：

• 校验XML编码格式：确认文件保存为无BOM的UTF-8编码，避免Windows记事本默认保存带BOM的UTF-8文件导致解析器识别失败，可通过VS Code等编辑器右下角的编码选项调整后重新保存。
• 校验根节点Uri属性：<AppInstaller>标签的Uri值必须和你部署到服务器后该文件的实际访问地址完全一致，路径大小写、域名、协议头都不能有偏差。
• 校验MainBundle属性和安装包的匹配度：MainBundle下的Name、Version、Publisher三个属性，必须和你.msixbundle包内AppxManifest.xml文件中的对应属性完全相同：
  1. 将.msixbundle后缀修改为.zip后解压，找到里面的AppxManifest.xml文件
  2. 核对三个属性值，尤其是Publisher字段，必须和打包证书的主题完全一致，不能遗漏任何DN段（比如漏写O=、OU=字段等）
• 校验命名空间版本：你当前使用的2018版命名空间http://schemas.microsoft.com/appx/appinstaller/2018最低支持Windows 10 1809版本，若测试设备系统版本低于该要求，需更换为对应系统支持的低版本命名空间（如2017版对应Windows 10 1709）。

第二步：解决web端访问报“解析应用包错误”的问题 #

本地运行.appinstaller正常后，线上访问仍报错按以下步骤排查：

• 补全MIME类型配置：除了你已配置的类型外，必须额外添加.msixbundle对应的MIME类型application/msixbundle，否则服务器会拒绝返回该类型资源。
• 开启范围请求支持：appinstaller安装时会分段请求安装包，若你的web服务器/CDN/反向代理禁用了Range请求，会导致解析失败。可通过命令curl -H Range:bytes=0-100 你的msixbundle访问地址 -I测试，若返回状态码不是206 Partial Content，需要放开范围请求限制。
• 校验HTTPS证书有效性：确认客户端设备完全信任站点的SSL证书，自签证书需要提前导入到客户端的受信任根证书存储区，证书过期、域名不匹配都会导致资源访问被拦截。

验证步骤 #

所有配置修改完成后，先清空服务器、CDN的缓存，再重新发起安装测试即可。

内容的提问来源于stack exchange，提问作者Justas Puodžius