WSABuilds 0x80073CF6 注册失败修复WSA 安装报错排查、日志获取与子错误定位实战指南【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds在 WSABuildsMagiskOnWSA预构建包中执行Run.bat安装 Windows Subsystem for AndroidWSA时Add-AppxPackage可能抛出HRESULT: 0x80073CF6, Package could not be registered导致安装失败。本文基于仓库内的 Fix Error 0x80073CF6.md 整理完整覆盖前置修复步骤、通过Get-AppPackageLog获取 ActivityID 日志的排障流程以及两类典型子错误0x800706D9端点映射器、0x80073B06初始屏幕图像的定位与修复方案并结合仓库中的安装脚本源码说明每个步骤背后的实现依据。读完后你应当能够独立完成一次完整的注册失败排查闭环。错误定位0x80073CF6 发生在安装链路的哪一步该错误的典型输出如下原文档给出的报错样例Add-AppxPackage : Deployment failed with HRESULT: 0x80073CF6, Package could not be registered In E:\WSA\Install.ps1:102 Character:1 Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion CategoryInfo : WriteError: (E:\WSA\AppxManifest.xml:String) [Add-AppxPackage], IOException FullyQualifiedErrorId : DeploymentError,Microsoft.Windows.Appx.PackageManager.Commands.AddAppxPackageCommand0x80073CF6的含义是包Package无法完成注册。要理解它先看仓库中安装脚本的实际调用链Run.bat 是整个安装入口。它先检查当前目录存在Install.ps1再以powershell.exe -ExecutionPolicy Bypass -File .\Install.ps1启动安装Run.bat。Install.ps1x64 与 arm64 版本内容一致分别位于 x64/Install.ps1 与 arm64/Install.ps1依次完成管理员权限自检与非管理员时自动提权重跑Install.ps1依据filelist.txt校验文件完整性缺失即提示重新构建Install.ps1若存在MakePri.ps1与makepri.exe先执行资源合并Install.ps1写入注册表AllowDevelopmentWithoutDevLicense、按需启用VirtualMachinePlatform可选功能Install.ps1按AppxManifest.xml声明检查并安装依赖包Install.ps1关键一步执行注册命令Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xmlInstall.ps1。报错即出现在这最后一步包注册失败。源码中还有一段针对“更新场景”的回退逻辑——若旧版 WSA 已存在且注册失败脚本会提示用Remove-AppxPackage -PreserveApplicationData保留用户数据卸载后重新注册Install.ps1这也是后续手动排障时可以借鉴的降级思路。需要特别说明的环境因素原文档 Preface 部分该问题可由多种因素共同导致阻止包注册完成因此没有单一的“确定解”只能按步骤逐一排查使用ReviOS、Tiny10/11 等精简/修改版 Windows的系统上更容易出现该问题因为这些系统移除了部分“非必要”功能组件而 WSA 的注册流程依赖其中一些组件。前置修复步骤按顺序执行在深入日志之前先执行原文档给出的 4 个前置步骤。很多 0x80073CF6 仅靠这几步即可解决。1. 确认安装所在分区/驱动器为 NTFS 文件系统WSA 的安装目录必须位于 NTFS 分区。从 exFAT/FAT32 分区常见于部分移动硬盘或 Windows To Go 环境直接运行安装注册流程可能失败。这是原文档列出的第一个排查项。2. 重新下载 WSA Build 压缩包下载或解压过程中文件损坏是常见诱因。建议重新下载后用 SHA256 校验确认文件未损坏仓库的 Checksum.md 给出了具体命令# 方式一certutil certutil -hashfile WSA_2XXX.XXXXX.X.X_XXXX_....zip SHA256 # 方式二PowerShell 原生 (Get-FileHash -Path WSA_2XXX.XXXXX.X.X_XXXX_....zip -Algorithm SHA256).Hash若哈希与发布页提供的不一致重新下载后再校验。另外提醒安装脚本自身依赖filelist.txt做文件完整性检查Install.ps1压缩包解压不完整时也会在这里或后续注册阶段暴露问题。3. 清理历史 WSA 安装残留如果此前安装过 WSA必须先彻底卸载并删除以下目录含子目录中所有包含WindowsSubsystemForAndroid字样的文件夹C:\ProgramData\Microsoft\Windows\AppRepositoryC:\ProgramData\Microsoft\Windows\WindowsApps%localappdata\ProgramData\Packages这三处分别对应包仓库数据库、Apps 目录快捷方式与应用数据目录是注册器判定“包是否已存在”的依据。残留数据是导致重复注册冲突的常见原因。完整的卸载流程含MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe数据目录的确认删除可参考 Uninstallation.md。4. 重启计算机完成后再次尝试安装。若问题已解决无需继续后面的日志排查若仍然报0x80073CF6则必须获取日志以精确定位根因。获取诊断日志用 ActivityID 还原注册失败细节前置步骤无效时原文档要求的下一步是主动复现失败并抓取 AppX 部署日志。此流程需要管理员权限打开 PowerShell把工作目录切换到 WSA 安装目录即AppxManifest.xml所在目录Set-Location X:\WSA\WSA手动执行与 Install.ps1 完全相同的注册命令。该命令应当再次失败但错误信息中会带出一个 ActivityIDUUIDAdd-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml用这个 UUID 查询本次失败操作的完整日志Get-AppPackageLog -ActivityID UUIDGet-AppPackageLog输出中会包含具体的子错误码与文字描述据此对照下一节的分类修复方案。子错误 10x800706D9 “There are no more endpoints avaliable from endpoint mapper”当日志中出现0x800706D9endpoint mapper 无可用端点时根因通常指向防火墙/网络通信组件异常——AppX 注册过程中需要与本机网络端点服务通信防火墙服务被禁用或被第三方防火墙拦截都会触发该错误。Windows 自带防火墙的修复步骤确认 Windows Defender 防火墙处于开启状态且启用了“Recommended Settings推荐设置”确认 Windows 防火墙服务正在运行若未运行则将其启用重启计算机。第三方防火墙的修复步骤确认第三方防火墙处于开启且正常工作状态并启用“Recommended Settings”确认该防火墙没有阻止或拦截新的条目写入某些安全软件会限制防火墙规则的自动添加而 AppX 注册依赖防火墙端点规则重启计算机。子错误 20x80073B06 “Initial screen image for the current application context cannot be recognized”当日志中出现如下形式原文档样例的错误时Installing MagiskOnWSA... Add AppxPackage: Deployment failed due to HRESULT: 0x80073CF6, unable to register the package. AppxManifest.xml (24,27): Error 0x80073B06: Unable to install or update package MicrosoftCorporateII.WindowsSubsystemForAndroid_8wekyb3d8bbwe because the initial screen image for the current application context cannot be recognized. ...含义是注册器无法识别当前应用上下文语言/DPI/对比度等下的初始屏幕Splash Screen图像。从仓库源码看Splash Screen 等资源在打包时由pri资源经makepri.exe new合并生成resources.pri并把各语言xml资源节点注入AppxManifest.xml的Package/ResourcesMakePri.ps1。如果这一步产出的资源文件损坏或不完整注册器解析 AppxManifest 引用初始屏幕图像时就会报0x80073B06——因此该错误本质上是构建/资源文件层面的问题而不是本机环境配置问题。修复方案二选一自构建场景如果你是用 MagiskOnWSA 本地构建MagiskOnWSALocal或 WSA-Script 这类脚本自行打包后安装的请删除之前构建的产物并重新构建使用 MagiskOnWSALocal 构建时务必删除并重新克隆 git 仓库避免使用脏工作区预构建包场景如果你安装的是发布页提供的预构建包请重新下载最新的构建再安装若问题依旧向项目 Issues 反馈。适用前提与相关排查适用前提本文流程适用于通过 WSABuilds 预构建包含 Magisk/KernelSU、MindTheGapps 等变体在 Windows 10/11 x64/arm64 上以Run.bat方式安装的 WSA所有 PowerShell 命令需在管理员权限下执行错误码区分0x80073CF6是“包注册失败”的总错误码真正根因要看Get-AppPackageLog中的子错误码若你遇到的是0x80073CF0通常是压缩包文件名/目录名过长、文件损坏导致应转而参考 Fix Error 0x80073CF0.md 与 FixPathTooLong.md修改版 WindowsReviOS、Tiny10/11 等用户即使完成全部步骤仍可能失败因为缺失的组件无法通过上述步骤恢复此时最稳妥的做法是换用原版 Windows 镜像验证。排查流程速查表步骤操作依据1确认安装分区为 NTFS原文档前置步骤 12重新下载并用 SHA256 校验压缩包Checksum.md3彻底卸载旧 WSA清理 AppRepository / WindowsApps / Packages 下的WindowsSubsystemForAndroid残留Uninstallation.md4重启后重试安装原文档前置步骤 45手动执行Add-AppxPackage ... -Register .\AppxManifest.xml复现失败取出 ActivityID与 Install.ps1 同源命令6Get-AppPackageLog -ActivityID UUID查看子错误码原文档日志获取流程70x800706D9→ 修复防火墙状态与服务0x80073B06→ 重新构建或重新下载预构建包原文档 Issue 1 / Issue 2【免费下载链接】WSABuildsRun Windows Subsystem For Android on your Windows 10 and Windows 11 PC using prebuilt binaries with Google Play Store (MindTheGapps) and/or Magisk or KernelSU (root solutions) built in.项目地址: https://gitcode.com/GitHub_Trending/ws/WSABuilds创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考