WSABuilds 排错指南：Run.bat 安装 WSA 报 Error 0x80073CF9 的原因分析与完整解决流程

WSABuilds 排错指南Run.bat 安装 WSA 报 Error 0x80073CF9 的原因分析与完整解决流程【免费下载链接】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本文基于 WSABuilds 仓库中的排错文档 Fix Error 0x80073CF9.md聚焦使用Run.bat安装 Windows Subsystem for AndroidWSA时最常见的部署错误 Error 0x80073CF9。文章完整梳理了“压缩包损坏”与“路径过长”两大成因给出可直接复现的 6 步修复流程含 SHA-256 校验命令与重命名示例并结合仓库中的安装脚本源码剖析Run.bat → Install.ps1的真实调用链与自校验逻辑帮助你在再次遇到同类部署错误时快速定位失败环节。错误背景0x80073CF9 是什么、从哪冒出来原始文档对该问题的定义是执行Run.bat安装 WSA 时出现 Error 0x80073CF9。文档归纳的两大主因是文件损坏下载.zip压缩包或从.zip中解压时文件发生损坏corruption of files when downloading the .zip files or extracting from the .zip files文件夹名过长MagiskOnWSA/WSABuilds 的构建脚本倾向于为.zip文件名以及压缩包内的根文件夹生成一段很长的字符串从而触发“路径过长”类问题。从源码结构看这个错误实际发生在“把解压产物注册为 Appx 包”的部署环节。安装入口 Run.bat 的全部逻辑就是检查同目录下是否存在Install.ps1然后以-ExecutionPolicy Bypass拉起 PowerShell 执行它if not exist Install.ps1 ( echo Install.ps1 is not found. echo Press any key to exit pausenul exit 1 ) else ( start powershell.exe -ExecutionPolicy Bypass -File .\Install.ps1 exit )而 Install.ps1 会解析AppxManifest.xml逐个用Add-AppxPackage安装依赖包最后通过Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml完成主包注册Install.ps1#L122-L178。因此 0x80073CF9 这类来自 Windows 应用包部署子系统的错误码本质上是“解压出的包文件不完整或路径异常导致注册失败”的集中体现——这也解释了为什么原始文档把“重新下载 重命名缩短路径”作为核心解法。修复流程原始文档 6 步方案完整继承第 1 步确认安装所在分区/磁盘为 NTFS将压缩包放置并解压的目标驱动器必须是 NTFS 文件系统。从 Windows 行为看FAT/exFAT 等格式在长路径与文件属性上的限制更多更容易放大“路径过长”和注册失败的问题文档把这一条列为第一前提。第 2 步重新下载 WSA.zip压缩包文件可能在下载或解压过程中损坏需要到项目的 Release 页面重新下载.zip压缩包原始文档中链接指向当时仓库的 Release 页面现该仓库即 WSABuilds 项目请在其 Release 页面获取最新构建。下载后建议按仓库内的 Checksum 校验指南 核对 SHA-256确认压缩包完整后再进入安装# 定位到压缩包所在目录 cd {X:\path\to\your\downloaded\archive\package} # 方式一certutil certutil -hashfile WSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon SHA256 # 方式二PowerShell 原生 (Get-FileHash -Path WSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazon -Algorithm SHA256).Hash若输出的哈希与 Release 页面所列值Custom Build 产物则对照sha256-checksum.txt不一致必须重新下载后再校验一次。第 3 步把.zip压缩包重命名为更短的名字名字可以自定。原始文档给出的示例WSA_2xxx.xxxxx.xx.x_x64_Release-Nightly-with-magisk-xxxxxxx-MindTheGapps-13.0-as-Pixel-5-RemovedAmazon→WSAArchive2XXX第 4 步使用 WinRAR 等专业压缩工具解压不要用 Windows 自带解压文档明确建议用 WinRAR 或同等可靠的专业归档工具解压避免使用 Windows 内置的.zip提取器其对长路径与特殊文件名的处理更容易产生异常文件。第 5 步把解压出来的文件夹也重命名为更短的名字Before:WSA_2XXX.XXXXX.X.X_XXXX_Release-Nightly-with-magisk-XXXXXXX-XXXXXX-MindTheGapps-XX.X-RemovedAmazonAfter:WSAExtracted2XXX这一步与仓库中单独的 FixPathTooLong.md 指南互为印证路径过长既会导致解压阶段报错也会让后续Add-AppxPackage注册时的临时部署路径超限。第 6 步以管理员身份运行Run.bat安装脚本本身带有一道管理员自检Install.ps1#L20-L27 的Test-Administrator函数通过WindowsIdentity::GetCurrent()判断当前用户是否处于 Administrator 角色若不是脚本会调用Start-Process -Verb RunAs触发 UAC 提权再在提权后的进程中重新执行自身Install.ps1#L66-L77。手动以管理员身份运行可以省去这一层额外跳转也减少提权链路上的干扰变量。源码级剖析为什么这套流程能修好 0x80073CF9把 6 步方案放回 Install.ps1 的实际执行链中可以逐条对应上脚本内的检查与容错逻辑1. 文件清单完整性自检对应第 2、4 步脚本在安装前会读取压缩包根目录的filelist.txt并逐一校验文件是否存在Install.ps1#L83-L88$FileList Get-Content -Path .\filelist.txt If (((Test-Path -Path $FileList) -Eq $false).Count) { Write-Error Some files are missing in the folder. Please try to build again. Press any key to exit $null $Host.UI.RawUI.ReadKey(NoEcho,IncludeKeyDown) exit 1 }也就是说“压缩包损坏/解压不完整”在脚本侧的直接表现就是filelist.txt校验失败并提前退出即便侥幸越过这道检查残缺的文件也会让后续的Add-AppxPackage -Register抛出 0x80073CFx 系列部署错误。这是“重新下载 SHA-256 校验 专业工具解压”三步组合的意义所在。2. 资源合并 MakePri对应路径问题的又一诱因若同目录同时存在MakePri.ps1与makepri.exe脚本会先执行资源合并Install.ps1#L90-L98该步骤失败时仅提示“WSA Settings 将始终为英文”不阻塞安装——说明安装流程对部分产物缺失做了降级容忍但对包文件本身没有容忍余地。3. 虚拟机平台特性检查脚本会检查VirtualMachinePlatform可选特性未启用时调用Enable-WindowsOptionalFeature -Online -NoRestart并提示需要重启才能生效Install.ps1#L110-L120。排查安装失败时应确认这一步已通过、系统已重启。4. 注册与回退0x80073CF9 的最终落点注册前脚本会先用WsaClient /shutdown关闭正在运行的 WSA 并结束WsaClient进程Install.ps1#L159-L163然后执行注册若注册失败且机器上已存在旧版 WSA脚本会进入回退分支Remove-AppxPackage -PreserveApplicationData保留用户数据卸载旧包再重新注册Install.ps1#L165-L178。可以推断当 0x80073CF9 与旧 WSA 残留/依赖包版本冲突叠加出现时可先手动移除旧包再走一遍干净的 6 步流程。相关排错文档索引0x80073CF9 属于一组部署错误码0x80073CF0 / CF6 / CF9 / CFB / CFD / D10仓库在MagiskOnWSA/DLL/docs/Fixes/下为每个错误码都提供了独立修复文档遇到邻近错误码时可对照排查Fix Error 0x80073CF0.mdFix Error 0x80073CF6.mdFix Error 0x80073CFB.mdFix Error 0x80073CFD.mdFix Error 0x80073D10.mdFixPathTooLong.mdChecksum.md同一修复方案在仓库内还有两份镜像文档可交叉参考MagiskOnWSA/docs/Fixes/Fix Error 0x80073CF9.md 与 Documentation/Fix Guides/Pre-Install Issues/Fix Error 0x80073CF9.md后者还补充了.7z压缩包与 7-Zip 解压的说明适用于以.7z形式发布的构建。执行前速查清单检查项达标标准对应修复步骤目标磁盘文件系统NTFS第 1 步压缩包完整性SHA-256 与 Release 页/sha256-checksum.txt一致第 2 步压缩包文件名已重命名为短名如WSAArchive2XXX第 3 步解压工具WinRAR / 7-Zip 等专业工具非 Windows 内置提取器第 4 步解压产物文件夹名已重命名为短名如WSAExtracted2XXX第 5 步运行身份以管理员身份运行Run.bat第 6 步按此顺序执行完毕后Install.ps1将依次通过文件清单校验、资源合并、可选特性检查与包注册0x80073CF9 这一由“包文件不完整/路径异常”引发的部署错误即可排除若仍失败再参照上文第 4 点检查旧 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考