Apache DataFusion CI 流水线因 GitHub 缓存服务迁移导致构建失败分析

Apache DataFusion 项目近期在持续集成（CI）流程中遇到了构建失败的问题，其根本原因是 GitHub 正在对其缓存服务进行迁移升级。本文将深入分析这一技术问题的背景、影响范围以及解决方案。

问题背景

GitHub 官方正在对其 Actions 缓存服务进行架构升级，原有的旧版缓存服务将于 2025 年 4 月 15 日正式停用。这一变更影响了所有依赖 GitHub Actions 缓存功能的项目，包括 Apache DataFusion。

在构建过程中，项目使用了 sccache 工具来加速 Rust 代码的编译过程。当 sccache 尝试访问旧版缓存服务时，服务返回了明确的错误信息，指出该遗留服务即将停用，并提示用户尽快迁移到新服务。

技术影响分析

缓存服务迁移导致的具体错误表现为 sccache 服务启动失败，错误信息明确指出缓存存储读取失败。这种错误属于永久性错误，意味着如果不进行干预，所有依赖缓存功能的 CI 流水线将持续失败。

对于 Apache DataFusion 项目而言，这一问题影响了所有使用 GitHub Actions 的自动化构建、测试流程，可能导致：

1. 代码提交后的自动化验证失败
2. 拉取请求的自动化检查无法通过
3. 开发者的工作效率下降，因为无法利用缓存加速构建过程

解决方案

要解决这一问题，需要进行以下技术调整：

1. 升级 actions/cache 版本：需要检查并更新项目中所有 GitHub Actions 工作流文件，确保使用的 actions/cache 是最新版本，该版本已经适配了新的缓存服务。

2. 更新 sccache-action：项目使用的 Mozilla sccache-action 也需要升级到最新版本（v0.0.8 或更高），该版本已经解决了与新缓存服务的兼容性问题。

3. 全面测试：在完成上述升级后，需要全面测试 CI 流水线的各个场景，确保缓存功能在所有工作流中都能正常运作。

实施建议

对于类似 Apache DataFusion 这样的大型开源项目，建议采取以下步骤进行平滑迁移：

1. 首先在开发分支进行变更和测试
2. 逐步更新各个工作流文件中的缓存相关配置
3. 监控构建时间和成功率，验证缓存效果
4. 确认稳定后合并到主分支

总结

GitHub 缓存服务的迁移是平台基础设施的重要升级，虽然短期内可能造成一些兼容性问题，但从长期来看将提供更稳定、高效的缓存服务。Apache DataFusion 项目团队及时识别并解决了这一问题，确保了项目的持续集成流程能够继续高效运行。对于其他使用 GitHub Actions 的开源项目，这也是一次重要的经验参考。