Apollo项目游戏流式传输问题排查指南

问题现象分析

在Apollo项目的使用过程中，部分用户报告了以下两个主要问题：

1. 游戏列表无法正常显示，包括桌面模式和Steam大图模式
2. 从Mac设备发起流式传输时出现404错误

这些问题通常出现在从0.2.9版本降级到早期版本后，或者在升级到3.0稳定版后突然出现。值得注意的是，这些问题同时影响了Windows 11主机和iOS客户端(Mac和iPhone)的使用体验。

根本原因

经过技术分析，这些问题主要源于配置文件(apps.json)中的版本标识冲突。当用户进行版本降级操作时，系统会在配置文件中保留"version": "2"的标记，而这一标记与新版本的配置结构不兼容，导致系统无法正确解析游戏列表和建立流式传输连接。

解决方案

方法一：手动修改配置文件

1. 定位到Apollo的配置文件apps.json
2. 查找并删除包含"version": "2"的整行内容
3. 确保删除该行后，前一行末尾的逗号也被移除，保持JSON格式的有效性
4. 保存文件并重启Apollo服务

方法二：完全重置配置

如果手动修改后问题仍然存在，或者用户不熟悉JSON文件编辑，可以采用更彻底的重置方案：

1. 备份现有的Apollo配置(如有需要)
2. 完全卸载Apollo应用
3. 删除所有相关配置文件和缓存
4. 重新安装最新版本的Apollo
5. 重新配置所有参数

预防措施

为避免类似问题再次发生，建议用户：

1. 在进行版本升级或降级前，备份重要配置
2. 尽量避免频繁的版本回退操作
3. 关注官方更新日志，了解版本间的兼容性说明
4. 定期检查配置文件的完整性

技术背景

Apollo作为一款跨平台的游戏流式传输解决方案，其配置管理系统需要处理不同版本间的数据结构差异。当检测到版本降级操作时，系统应自动清理不兼容的配置标记，但某些情况下这一机制可能失效，导致用户需要手动干预。

通过理解这些技术细节，用户可以更好地维护自己的Apollo环境，确保游戏流式传输体验的稳定性。