WSA安装报错速查：WSABuilds 6类安装失败错误代码，逐一给出解决路径-育师

WSA安装报错速查：WSABuilds 6类安装失败错误代码，逐一给出解决路径

【免费下载链接】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 是一个把 Android 子系统（Windows Subsystem for Android，简称 WSA）做成即装即用预构建包的开源项目，基于 Windows 10 和 Windows 11，可选带 Google Play 商店的 GApps 版本，以及 Magisk / KernelSU 两种 root 方案。WSA 安装失败大多不是出在"装"这个动作上，而是卡在解压、脚本执行、包注册这三个环节——错误码 0x80073CF6、0x80073D10、"路径太长"、"登录会话不存在"这类提示，基本都对应一个可确认的具体原因。你只需要对照本文找到对应章节按步骤操作，就能把绝大多数安装失败问题处理掉。

安装前快速自查：先确认你属于哪种情况

🔍 动手修错之前，先花一分钟定位你的问题类型，直接跳到对应章节：

双击 Run.bat 后弹出黑窗口，提示以 0x 开头的十六进制错误码 → 按代码跳到「按错误代码查解决路径」中的对应小节
没有错误码，黑窗口一闪而过，或者提示 Install.ps1 找不到、文件缺失 → 跳到「Install.ps1 无法执行或找不到」
安装脚本跑完了，但 WSA 打不开、没有启动画面、开始菜单里看不到应用图标 → 跳到「装完后 WSA 打不开、无启动画面」
提示与虚拟化、Hypervisor、虚拟内存平台相关 → 跳到「虚拟化报错」
解压 .7z / .zip 时就报"路径太长"，或运行脚本提示"Internet 安全设置阻止了文件打开" → 跳到「路径太长与安全设置拦截」

按错误代码查解决路径

错误代码 0x80073CF6：包注册失败

症状：运行 Run.bat 时窗口报Deployment failed with HRESULT: 0x80073CF6, Package could not be registered。

问题本质：Appx 包注册被系统环境挡住了。这个代码背后可能有多种原因，需要先排除最常见的一批，再靠日志确认具体是哪一种。

操作路径：

确认 WSA 所在分区是 NTFS 格式（exFAT 不支持注册），用右键"属性"即可查看文件系统。
重新下载完整构建包。下载中断或解压损坏都会触发这个错误。
如果你之前装过 WSA，先按官方卸载文档完全卸载，并删除下面三个目录中所有名称包含WindowsSubsystemForAndroid的文件夹：
- C:\ProgramData\Microsoft\Windows\AppRepository
- C:\ProgramData\Microsoft\Windows\WindowsApps
- %localappdata%\ProgramData\Packages
重启电脑后再次运行 Run.bat。

如果到这里还没好，就取一份详细注册日志来定位真正的原因：

以管理员身份打开 PowerShell，把当前目录切到 WSA 安装文件夹：cd "你的WSA安装路径"—— 切换到安装包所在位置。
执行Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml—— 故意让注册再失败一次，屏幕上会显示一个 ActivityID（一串 UUID）。
执行Get-AppPackageLog -ActivityID 你上一步看到的UUID—— 打印出这次失败操作的完整日志。

验证信号：日志能正常打印出来，说明诊断流程没走偏，接下来按日志内容分两条路走：

若日志里出现0x800706D9（endpoint mapper 无可用端点）：这是防火墙在作怪。打开 Windows 防火墙设置，确认防火墙处于开启状态且使用"推荐设置"；到"服务"里确认 Windows Firewall 服务正在运行；如果你用第三方防火墙，检查它是否允许新增规则条目。完成后重启电脑再装。
若日志里出现0x80073B06（启动屏幕图像无法识别）：若是你自己用脚本构建的包，删掉旧构建（含克隆的仓库）重新构建；若是官方预构建版本，重新下载一次最新构建。两者都无效时，说明是构建源的问题，等待或反馈新版本。

详见该错误代码的官方修复文档。

错误代码 0x80073D10：CPU 架构不匹配

症状：安装中途直接报架构不兼容，无法继续。

问题本质：你下载了与系统 CPU 架构不符的包——最典型的是在 x64 电脑上装了 arm64 版本（或反过来）。WSABuilds 的 Windows 11 包分 x64 和 arm64 两种，Windows 10 包为 x64。

操作路径：

打开设置 → 系统 → 关于，查看"系统类型"，确认你的电脑是 64 位（x64）还是 ARM64。
回到安装文档中的下载说明，按"操作系统 + 架构"重新选择对应资产下载，注意不要选成 Source code。
删掉之前下载错的文件，用正确的包重新解压安装。

验证信号：下载文件的命名或所属 release 页与你的系统类型一致；安装过程不再报架构错误。详见官方说明。

虚拟化报错：功能显示已启用却仍然失败

症状：WSA 无法启动或安装失败，提示与虚拟化相关；任务管理器里虚拟化明明显示"已启用"，相关功能也都勾了。

问题本质：Hyper-V 相关组件的状态残留冲突——某些功能曾经开关过，留下了不一致的内核启动状态，WSA 反而起不来。

操作路径（按官方虚拟化修复文档完整走一遍，顺序不能乱）：

卸载 WSA（右键"Windows Subsystem for Android Settings"选卸载），并删除解压出来的 WSA 安装文件夹。
打开"启用或关闭 Windows 功能"（Win+R 输入optionalfeatures.exe），把 Hyper-V、Virtual Machine Platform、Windows Hypervisor Platform、Windows Subsystem for Linux 四项全部取消勾选，重启。
进 BIOS 把虚拟化临时关闭，保存重启；同时在 Windows 安全中心 → 应用和浏览器控制 → 威胁和防护 → 漏洞利用保护里确认"控制流保护"是开启的。
以管理员身份打开 CMD，执行bcdedit /set hypervisorlaunchtype auto—— 让 Hypervisor 随系统自动启动，消除启动方式残留。
回到"启用或关闭 Windows 功能"，把刚才取消的四项重新勾选，再重启一次。
进 BIOS 把虚拟化重新打开，重启。
重新解压 WSA 包，运行 Run.bat 安装。

验证信号：任务管理器 → 性能中虚拟化显示"已启用"，且 WSA 图标能正常点开、出现 Android 启动画面。

Install.ps1 无法执行或找不到

症状：双击 Run.bat 后窗口一闪而过、没弹管理员授权框；或提示 Install.ps1 不是可识别的命令、文件夹里缺少文件。

问题本质：多半是文件夹路径太长、包含特殊字符，导致脚本定位自身文件失败；其次才是脚本本身没被赋予执行权限。

操作路径：

把解压出来的文件夹改名为短名称，例如把一长串版本字符串改成WSA（路径越长风险越大，这是官方文档明确建议的做法）。
右键该文件夹 → 显示更多选项 → 复制为路径，拿到干净的完整路径。
按 Win+X，选择 Windows 终端（管理员）或 PowerShell（管理员）。
输入cd "上一步复制的路径"回车 —— 进入安装目录。
输入PowerShell.exe -ExecutionPolicy Bypass -File .\Install.ps1回车 —— 以旁路执行策略的方式手动运行安装脚本。

验证信号：脚本逐行执行并在结束后 WSA 自动启动；若出现首次运行的诊断信息同意弹窗，点 OK 即可（出现两个相同弹窗属正常，都确认）。

Specified Logon Session Does Not Exist（指定的登录会话不存在）

症状：安装时弹出这条英文提示，包没有装上去。

问题本质：你当前使用的不是 Windows 管理员账户。未签名的 MSIX 包无法在非管理员账户下安装，这是系统限制。

操作路径：

打开 CMD，输入net localgroup administrators回车 —— 列出本机管理员组成员。
确认你当前登录的账户在列表里；不在的话，先切换到管理员账户。
用管理员账户右键 Run.bat → 以管理员身份运行（手动跑 Install.ps1 时同理，终端本身必须是管理员终端）。

验证信号：命令输出里能看到你的账户名，且之后安装不再报登录会话错误。

路径太长与安全设置拦截

症状：解压 .7z 时报 "Path is too long"；或运行脚本时提示 "Your Internet security settings prevented one or more files from opening"。

问题本质：构建包默认命名极长，叠加较长的存放路径后超出 Windows 的 260 字符路径上限；安全设置拦截则是同样的长路径触发系统安全策略的误判。

操作路径：

把 .7z / .zip 压缩包本身改短名，例如WSA.7z。
把解压出来的文件夹也改成短名，例如WSA，并尽量放在层级浅的位置（如D:\WSA）。
重新运行 Run.bat。

验证信号：解压完整无报错，脚本正常进入安装流程。参考路径问题与安全设置拦截两篇官方文档。

装完后 WSA 打不开、无启动画面

症状：安装流程走完了，但 WSA 应用无法启动，设置里打开 Files 没有启动画面，Android 应用也没有图标。

问题本质：官方文档标注原因为未知，但社区反复验证过的有效修复手段只有一个——安装文件夹名字过长导致组件无法加载。

操作路径：

把 WSA 安装文件夹重命名为短名称（如WSA）。
重新运行文件夹里的 Run.bat 重新注册。

验证信号：WSA 能弹出启动画面，应用列表出现图标。详见官方文档。

安装前环境与文件检查清单

✅ 下载并安装前，逐项确认以下事项，能避开一半以上的失败案例：

系统版本：Windows 11 为 Build 22000.526 或更高；Windows 10 为 22H2（10.0.19045.2311）或更高（Win10 用winver命令查看版本）
内存：8GB 为最低要求，16GB 体验更稳
系统盘（C:）至少 10GB 可用空间，优先 SSD
WSA 将安装到 NTFS 分区——右键分区属性确认文件系统，exFAT 不行
"启用或关闭 Windows 功能"中已勾选 Virtual Machine Platform 与 Windows Hypervisor Platform，并已重启
BIOS/UEFI 中虚拟化已开启（任务管理器 → 性能 → CPU 下方可见"虚拟化：已启用"）
你用的不是魔改精简版系统（ReviOS、Tiny 10/11 等移除过组件的系统安装容易失败）
已确认系统架构（x64 / arm64），将要下载的包与之匹配
如果此前装过官方 WSA 或其他 WSA 构建，已完全卸载（两套不能并存）
下载完成后备份了 .7z 文件；解压时用 7-Zip 等专用工具，不要用资源管理器右键解压长命名包

常见误区与后续维护

❌不要删除 WSA 安装文件夹。WSABuilds 是"注册式"安装，Add-AppxPackage 只是把已解压的文件夹注册成应用，删掉文件夹 = 直接报废，需要整包重装。

❌不要在 exFAT 分区安装。注册环节对文件系统有硬性要求，这类失败没有补救手段，只能换盘重装。

❌不要用普通账户跑安装。非管理员账户装未签名 MSIX 必然失败（即上文"登录会话"错误），装之前先确认账户。

❌不要混装。官方 WSA 与 WSABuilds 不能共存，升级时也是先卸载旧版再装新版；更新文档说明了合并文件夹替换文件的做法，别图省事新旧并存。

⚠️留意 GApps 版本的已知问题：项目 README 提示 2025 年 6 月之后，Windows 11 上的 GApps 构建存在崩溃问题，官方修复进行中。如果你不需要 Google Play，直接选文件名带NoGApps的构建更省心；需要 GApps 的用户可参考 README 顶部给出的临时方案。

装好之后的健康维护：

大版本更新前，先备份%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx（你的 Android 数据都在这一个文件里），恢复方法见备份与恢复文档。
更新走"合并文件夹、替换同名文件"的流程，跑一次 Run.bat 重新注册即可，无需重装。
偶尔可以检查 WSA 设置应用能否正常打开、ADB 调试是否可用，作为子系统健康的快速体检。
遇到新错误，先按 0x80073CF6 一节的方法取 Get-AppPackageLog 日志，比盲目重装有效得多。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考