知识库：缺少 .NET 8 和 .NET 10 运行时依赖项导致的 AES 8.x 升级问题

解决方案详情

升级到 AES 8.x 后出现的症状

升级到 AES v8.x 后，用户报告了以下症状：

• 通过 Altium Designer 25 可以正常访问项目和服务器。
• 仍可通过 Web 界面访问元件。
• 无法通过 AES Web 界面查看项目。
• 等待后重试也无法解决此问题。

尝试查看项目时，Web 界面显示以下消息：

用户在尝试访问 AES Web 前端时，也可能遇到 "The service is unavailable. 500: the server isn't responding."。

AES 8.x 引入的运行时依赖项变更

从 AES 8.x 开始，AES 服务器要求在服务器上同时安装 .NET 8 和 .NET 10 运行时。

从 AES v8.x 开始：

• 只有部分 AES 服务已迁移到 .NET 10。
• 大多数 AES 服务仍依赖于 .NET 8。
• 移除或未安装 .NET 8 或 .NET 10 中的任一版本，都可能导致服务启动失败和 Web 前端问题。

从 AES v8.x 开始，这种依赖模式属于预期行为；随着更多服务完成迁移，计划在未来的 AES 版本中对此进行调整。

建议的恢复方案

• 在保留 .NET 10 的同时安装最新的 .NET 8 运行时，并验证服务器功能是否正常。
• 如果问题仍然存在，请重新安装 AES，以自动恢复所有必需的运行时依赖项。
• 重新安装前，请对现有 AES 安装进行完整备份。

恢复 AES 功能的步骤

1. 检查 AES 服务器计算机上当前安装的 .NET 运行时。
2. 确认 .NET 8 和 .NET 10 已并行安装。
3. 如果缺少 .NET 8 或 .NET 10，请安装所缺版本的最新受支持运行时。
4. 如有需要，重启受影响的 AES 服务。
5. 测试能否访问 AES Web 前端。
6. 验证能否通过 Web 界面打开和查看项目。
7. 如果问题仍然存在，请备份 AES 安装。
8. 按照标准安装流程重新安装 AES v8.1.3.17。
9. 允许安装程序安装所有必需的依赖项。
10. 如有必要，从备份中恢复数据。
11. 验证 Web 前端和项目查看功能是否正常运行。

补充说明

• AES 8.x 要求服务器上始终同时安装 .NET 8 和 .NET 10 运行时。在未核实 AES 要求的情况下更新或移除运行时，可能导致服务故障、项目访问问题或 Web 前端不可用。
• 如果在 Windows 或 .NET 更新后无法访问 AES，请参阅这篇知识库文章，获取有关运行时相关访问问题及版本兼容性注意事项的更多指导。该文章主要适用于受 Windows 和 .NET 更新影响且已不受支持的 AES 版本。不过，在排查与运行时变更或 Web 服务可用性相关的类似症状时，该文章也可能有所帮助。

参考资料

• AES 安装期间安装或配置的其他软件
• Altium 本地部署企业服务器安装
• 备份与恢复安装