ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

WSA 安装失败?5 个常见报错的定位与修复完整指南

WSA 安装失败?5 个常见报错的定位与修复完整指南 WSA 安装失败5 个常见报错的定位与修复完整指南【免费下载链接】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 部署 Windows Subsystem for AndroidWSA构建包时Run.bat弹出0x80073CF6、0x80073D10之类的错误代码这篇指南带你逐个 WSA 安装失败场景做定位和修复先看 30 秒自诊表找到对应报错再按分情况处理路径操作最后装完做一次功能验证。跟着走基本都能把 WSA 恢复成可用状态。30 秒症状自诊报错代码对照表打开安装窗口后卡住或报错时先别乱删文件。对照下表确认你遇到的到底是哪一类问题再跳转到对应小节报错信息大概率原因去哪查Deployment failed ... 0x80073CF6, Package could not be registeredAppx 包注册失败残留文件、分区格式、文件损坏等0x80073CF6注册失败定位日志里出现0x800706D9no more endpoints availableWindows 防火墙拦截注册流程0x800706D9防火墙分支日志里出现0x80073B06启动图像无法识别构建包文件损坏或不完整0x80073B06包镜像分支0x80073D10提示包不受支持下载了与 CPU 架构不符的安装包0x80073D10架构不匹配提示虚拟化未启用、WSA 打不开BIOS 或 Windows 功能里虚拟化没开虚拟化未启用排查如果一时分不清0x80073CF6 小节里的日志获取方法能帮你拿到真正的错误代码。0x80073CF6注册失败的定位方法你看到的现象执行Run.bat安装脚本时窗口报Add-AppxPackage : Deployment failed with HRESULT: 0x80073CF6, Package could not be registered安装中断。官方对应的处理文档是 Fix Error 0x80073CF6。先做基础清理注册失败往往不是单一原因按顺序做这四件事做完就能装成功的概率很高确认安装分区是 NTFS。exFAT 分区不支持 WSA把构建包挪到 NTFS 盘再装。重新下载构建包。下载中断会造成文件损坏从 WSABuilds 官方仓库README 下载区重新拉一份完整的.7z用 7-Zip 解压。彻底卸载旧版并清理残留。如果你之前装过 WSA官方版或旧构建先按卸载指南完整卸载然后删掉下面三个目录里所有名字带WindowsSubsystemForAndroid的子目录C:\ProgramData\Microsoft\Windows\AppRepositoryC:\ProgramData\Microsoft\Windows\WindowsApps%localappdata%\ProgramData\Packages重启电脑让清理生效。清理后重装。如果依然报 0x80073CF6就进入下一步拿日志。用 ActivityID 拿到详细日志这一步的目的是让注册再失败一次但这次把失败细节抓出来。右键任务栏开始按钮选择以管理员身份运行 PowerShell。先切换到你的 WSA 解压目录把X:\WSA换成实际路径cd X:\WSA执行下面的注册命令。它还会失败这正是目的——命令输出里会带一个 UUIDActivityID把它复制下来Add-AppxPackage -ForceApplicationShutdown -ForceUpdateFromAnyVersion -Register .\AppxManifest.xml拿 UUID 查这次操作的完整日志把你的UUID原样替换保留尖括号里换成的实际值Get-AppPackageLog -ActivityID 你的UUID日志会打印出注册失败的真正原因。如果里面是下面两个代码之一就按对应分支处理。修复分支一日志里出现 0x800706D9说明是防火墙在作怪按下面三步处理保持 Windows 防火墙处于开启状态且使用推荐设置——关掉防火墙反而会让注册流程找不到端点。按WinR输入services.msc确认Windows 防火墙服务正在运行没运行的话把它启动。重启电脑让设置生效再跑一遍Run.bat。修复分支二日志里出现 0x80073B06这个代码表示包的启动图像识别不了本质是包文件本身的问题分两种情况你用的是自定义构建本地脚本构建出来的删掉旧的构建产物重新完整构建用本地构建脚本的话把仓库重新 clone 一遍再构建。你装的是预构建版本删除当前文件回到下载区重新下载最新构建再按安装指南装。如果两种情况都试过还不行直接带着这份日志去项目的 issue 系统里提单见文末求助渠道。0x80073D10架构不匹配对照系统类型重下你看到的现象安装过程提示包不受支持或架构不兼容安装直接失败。这个错误和系统环境无关就是包下错了。确认你的系统架构打开设置 → 系统 → 关于。看设备规格下的系统类型64 位操作系统基于 x64 处理器还是基于 ARM64 的处理器。记住结论去 WSABuilds 下载区 选对应的包。按架构重新下载安装包对照关系很直接Windows 11 x64 系统 → 下 Windows 11 x64 版本Windows 11 ARM64 系统 → 下 Windows 11 arm64 版本Windows 10 系统 → 下兼容 Windows 10 的 x64 版本删掉之前下错的包重新下载正确架构的版本按标准安装流程解压后运行Run.bat。更多细节可参考官方 Fix Error 0x80073D10 文档。虚拟化未启用从任务管理器到 BIOS 的三层检查你看到的现象WSA 无法启动或安装失败提示与虚拟化、Virtual Machine Platform 相关的错误。定位虚拟化到底哪一层没开虚拟化要三层都到位从上往下查BIOS 层按CtrlShiftEsc打开任务管理器切到性能选项卡查看 CPU 详情里虚拟化是否显示已启用。显示已禁用问题就在 BIOS/UEFI。Windows 功能层按WinR输入optionalfeatures.exe回车在弹出的启用或关闭 Windows 功能窗口里确认这三项都已勾选Hyper-VWindows Hypervisor Platform虚拟机平台系统功能层如果前两层都正常但 WSA 还是报虚拟化错误参考官方 FixVirtError 文档做深度处理。修复在optionalfeatures.exe里补齐上述勾选项点确定并重启电脑。如果任务管理器显示虚拟化已禁用重启进入 BIOS/UEFI找到虚拟化选项Intel 平台叫Intel VT-xAMD 平台叫AMD-V / SVM设为 Enabled保存退出。重启后重跑Run.bat验证。WSA 安装前检查清单装之前先过一遍装失败的大多数案例根子都在装之前。对照下面这份 WSA 安装前检查清单逐项确认能省下大量来回排查的时间系统要求✅ Windows 10 22H219045.2311或更高版本✅ 或 Windows 11 Build 22000.526 或更高版本✅ 内存至少 8GB推荐 16GB✅ 系统盘C 盘至少 10GB 可用空间✅ 安装分区为 NTFS 格式✅ 关闭第三方杀毒软件避免安装脚本被拦截✅ 以管理员身份运行安装脚本✅ 下载阶段保持网络连接稳定三个高频误区下面三件事做得越多WSA 越容易坏❌删除 WSA 安装文件夹。WSA 是注册式安装AppxManifest.xml指向的是这些解压出来的文件删掉文件夹 WSA 直接罢工。安装文件夹要长期保留。❌在非 NTFS 分区安装。exFAT 分区装不了 WSA这是硬性限制。❌旧版没卸载干净就装新版。先按卸载指南彻底卸载旧版想留数据就先备份userdata.vhdx再装新的。装后验证确认 WSA 真的能用了安装窗口显示完成后别急着收工做三项验证确认版本打开Windows Subsystem for Android 设置应用在关于页核对 WSA 版本号确认装的是你要装的那个构建。启动一个 Android 应用随便装一个轻量 App 跑起来能正常打开并响应触控就过关。检查 ADB 调试确认开发者选项里 ADB 调试可用命令行执行adb devices能看到 WSA 设备。有侧载需求的话这一步能提前暴露问题。紧急排查与求助渠道以上都试过还不行时按这个顺序做最后的排查查事件日志打开事件查看器在应用程序和服务日志 → 应用程序里找 WSA 相关条目的错误详情。查磁盘空间确认系统盘剩余空间充足空间不足也会让注册失败。体检系统文件以管理员身份打开命令提示符执行下面的命令跑完按提示重启sfc /scannow如果系统文件检查后依然装不上转向社区求助求助时信息越全回复越快先翻官方文档的故障排除章节Having Issues? 与 Troubleshooting 里维护着完整常见问题列表。到项目的 issue 系统里搜索你的错误代码看是否已有同问题的讨论。提单时附上Get-AppPackageLog输出的完整日志、Windows 版本号、CPU 架构、安装包文件名这些是关键定位信息。【免费下载链接】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),仅供参考
返回列表