Apollo项目应用保存功能故障分析与修复方案

问题背景

在Windows 11系统环境下，用户报告Apollo项目（版本v0.2.9-alpha.6）在重新安装后出现无法保存新增应用的问题。当用户尝试点击保存按钮时，系统无响应，并在日志中记录类型错误提示："SaveApp: [json.exception.type_error.302] type must be number, but is null"。

技术分析

该问题源于Sunshine项目API的重大变更导致的合并冲突。在代码合并过程中，开发团队遗漏了部分关键修改，具体表现为：

1. 类型验证失败：系统期望接收数值类型参数，但实际接收到null值
2. 数据序列化异常：应用配置信息无法正确写入持久化存储
3. 前端交互阻断：保存按钮的点击事件未能触发有效的后端处理流程

解决方案

开发团队在v0.2.9-alpha.7版本中已修复该问题，主要改进包括：

1. 完整适配Sunshine项目的新API规范
2. 修复JSON数据序列化过程中的类型校验逻辑
3. 确保前后端数据格式的一致性

配置存储说明

Apollo项目的应用配置文件默认存储路径为系统程序目录下的config子文件夹（典型路径：C:\Program Files\Apollo\config）。该目录包含关键的apps.json配置文件，建议用户：

1. 定期备份该配置文件
2. 升级前手动保存现有配置
3. 避免直接编辑原始配置文件

最佳实践建议

1. 版本升级：建议所有用户及时升级到alpha.7或更高版本
2. 故障排查：如遇类似问题，可优先检查日志中的JSON解析错误
3. 数据迁移：跨版本升级时注意配置文件格式兼容性
4. 开发建议：在API变更时建立完整的接口测试用例

总结

该案例展示了开源项目依赖管理的重要性，提醒开发者在合并上游变更时需要建立完善的回归测试机制。对于终端用户，及时更新到稳定版本是避免此类问题的有效方法。