Apollo SudoVDA Watchdog Failed 报错修复：一步重置显示设备缓存

【免费下载链接】ApolloSunshine fork - The easiest way to stream with the native resolution of your client device项目地址: https://gitcode.com/gh_mirrors/apollo18/Apollo

在 Apollo 里创建虚拟桌面时，设备状态显示Watchdog Failed（看门狗（Watchdog）失败），桌面卡在创建过程中？这个报错确实容易让人慌。其实它多半是显示设备缓存过期造成的，不用重装系统，也不用手动清注册表，通过 Apollo 的 Troubleshooting 页面一键重置即可。本文带你完成修复并逐项验证。

30 秒快速修复（TL;DR）

1. 打开 Apollo 的 Web 界面（浏览器访问本机 47989 端口），登录后进入Troubleshooting标签页。
2. 找到卡片Reset Persistent Display Device Settings，点击其中同名按钮。
3. 看到绿色成功提示后，在Quit & Restart区域重启 Apollo。
4. 重新创建虚拟桌面，确认驱动状态恢复正常。

报错长什么样

如果你的环境不是 Windows 平台，或从不创建虚拟桌面，可跳过本文——Reset Persistent Display Device Settings按钮只在 Windows 下显示。

为什么会这样（机制拆解）

• 缓存：Windows 显示子系统用注册表缓存记录显示设备信息，包括设备实例路径（Device Instance Path，系统用来唯一标识一块显示设备的字符串）。所以虚拟桌面每次创建/销毁，都会往缓存里写新记录。
• 过期：缓存里长期累积已失效的设备条目，新设备创建时系统按旧记录匹配，资源分配互相冲突。所以修复时我们要做的是把这份持久化设置整体重置，而不是逐条找坏记录。
• 冲突触发看门狗：驱动状态记录残留后，驱动是否"活着"的超时判定（即 Watchdog）会持续收到过期的超时计数，新设备拿不到干净的资源，于是状态直接落到Watchdog Failed。所以重置缓存后必须重启 Apollo，让驱动按全新记录重新走一遍枚举。

逐步修复与验证（重置持久化显示设备设置的操作路径）

1. 进入入口：浏览器打开 Apollo Web 界面，登录后点击Troubleshooting标签。验证点：页面能正常加载且左侧导航高亮在该标签。
2. 执行重置：向下滚动到Reset Persistent Display Device Settings卡片，点击其中的Reset Persistent Display Device Settings按钮。验证点：按钮上方出现绿色成功提示；如果上一步未生效并出现红色失败提示，先确认当前确实是 Windows 平台、且 Apollo 以管理员身份运行，然后重试一次。
3. 重启应用：在同页Quit & Restart区域点击重启。验证点：服务进程退出后自动拉起，浏览器刷新页面能再次登录。
4. 确认恢复：重新进入虚拟桌面。验证点：驱动状态不再出现Watchdog Failed，桌面从"创建中"进入可用画面。

修复后自查清单

• 用 Steam Deck 与 iOS 客户端各连接一次，均能正常进入虚拟桌面画面
• 打开Apollo.txt日志，搜索Watchdog或SUDOVDA，不再新增超时报错行
• 显卡驱动保持在最新稳定版，Windows 更新处于最新状态
• 长期观察：每月或系统大版本更新前，主动执行一次该缓存重置；之后若再次出现Watchdog Failed，直接重走本文流程

延伸：同类报错自查方向

若上述步骤无效，下一步先收集Apollo.txt中Watchdog/SUDOVDA相关行，对照 docs/troubleshooting.md 的其他条目逐一排除，再携带日志与系统版本到项目社区反馈渠道求助。仍无法定位时，问题多半下沉到显卡驱动层或 Windows 显示子系统本身，需要更新驱动、检查 Windows 更新后再复测。

【免费下载链接】ApolloSunshine fork - The easiest way to stream with the native resolution of your client device项目地址: https://gitcode.com/gh_mirrors/apollo18/Apollo