Eclipse Che 旧版本文档访问问题解析

问题背景

在 Eclipse Che 7.81 版本中，用户反馈无法正常访问旧版本（如 7.41）的文档内容。当用户尝试通过版本下拉菜单切换至旧版本时，系统会自动重定向至当前版本页面，无法获取所需的历史文档资料。

技术分析

经过开发团队确认，这是系统预期行为而非故障。Eclipse Che 项目出于维护成本和技术演进考虑，不再为过旧版本（如 7.41）提供在线文档服务。该决策基于以下几点技术考量：

1. 版本兼容性：7.41 版本发布于较早期，其架构和功能与当前版本存在显著差异
2. 维护成本：为每个历史版本维护独立文档站点需要大量资源
3. 稳定性考量：旧版本可能存在已知问题，官方不鼓励继续使用

解决方案

对于确实需要查阅旧版本文档的用户，可以采用以下替代方案：

1. 本地构建文档：从对应的 Git 分支（如 7.41.x）克隆代码库并本地构建文档
2. 版本升级：强烈建议用户升级至最新稳定版本，以获得完整的技术支持和功能更新

特别说明

对于使用 Azure Kubernetes Service (AKS) 的用户，若遇到 OIDC 认证相关问题阻碍升级，可考虑以下技术方案：

1. 使用 vcluster 等虚拟集群解决方案
2. 评估替代的身份认证方案

最佳实践建议

1. 生产环境应尽量保持使用受支持的稳定版本
2. 如需长期使用特定旧版本，建议完整下载并归档相关文档资源
3. 定期评估升级路径，避免技术债务积累

项目团队将持续优化文档体系，同时提醒用户关注版本生命周期，合理安排升级计划。