Mozilla sccache v0.10.0 版本在 GitHub Actions 中的缓存服务兼容性问题解析

问题背景

sccache 是 Mozilla 开发的一款分布式编译缓存工具，能够显著加速编译过程。近期有用户在使用 sccache v0.10.0 版本与 GitHub Actions 集成时遇到了缓存服务兼容性问题，表现为构建过程中出现"legacy service is shutting down"的错误提示。

问题现象

用户在 GitHub Actions 环境中配置 sccache 后，虽然使用了最新的 v0.10.0 版本，但仍然收到以下错误信息：

sccache: error: Server startup failed: cache storage failed to read: Unexpected (permanent) at read => {"$id":"1","innerException":null,"message":"This legacy service is shutting down, effective April 15, 2025. Migrate to the new service ASAP. For more information: [https://gh.io/gha-cache-sunset](https://gh.io/gha-cache-sunset)","typeName":"Microsoft.Azure.DevOps.ArtifactCache.WebApi.ArtifactCacheServiceDecommissionedException, Microsoft.Azure.DevOps.ArtifactCache.WebApi","typeKey":"ArtifactCacheServiceDecommissionedException","errorCode":0,"eventId":3000}

从日志中可以观察到，sccache 尝试使用 GitHub Actions 缓存服务(GHAC)的 V1 版本，但该服务已计划于 2025 年 4 月 15 日停止使用。

技术分析

1. 服务架构变更：GitHub 正在对其 Actions 缓存服务进行升级，旧版 V1 API 将被弃用，转而使用新版服务。

2. sccache 实现机制：sccache 通过 OpenDAL 库与 GHAC 服务交互。从日志可见，当前配置强制使用了 V1 版本的缓存服务：

   backend use service version V1
   backend use version sccache-v0.10.0-1
   

3. 版本兼容性：尽管 sccache v0.10.0 是最新版本，但其 GHAC 集成部分可能尚未完全适配 GitHub 的新缓存服务架构。

解决方案

目前有以下几种可行的解决路径：

1. 切换缓存后端：如用户最终采用的方案，可以改用其他缓存服务如 Depot，完全避开 GHAC 的兼容性问题。

2. 等待官方更新：关注 sccache 项目更新，等待官方发布完全支持新版 GHAC 服务的版本。

3. 临时降级方案：如果项目允许，可以考虑暂时禁用缓存功能，但这会牺牲编译速度优势。

最佳实践建议

1. 环境检查：在使用 sccache 前，建议先运行sccache --show-stats命令检查缓存服务状态。

2. 日志级别：设置SCCACHE_LOG=debug环境变量可以帮助诊断缓存相关问题。

3. 多方案准备：对于关键构建流程，建议准备备用缓存方案，如本地缓存或第三方缓存服务。

总结

sccache 作为编译加速工具在持续集成环境中非常有用，但需要注意其与各平台服务的兼容性。GitHub Actions 缓存服务的架构变更导致了一些兼容性问题，开发者需要根据自身情况选择合适的应对方案。对于长期项目，建议关注 sccache 项目的更新动态，及时升级到完全支持新版 GHAC 的版本。

未来随着 sccache 项目的持续发展，这类平台服务变更带来的兼容性问题有望得到更好的解决。开发者社区也在积极讨论和推动相关改进，以确保编译缓存功能在各种环境下都能稳定工作。