GitHub Actions Cache 性能问题分析与解决方案

问题现象

在使用 GitHub Actions 的 actions/cache@v3 时，特别是在自托管运行器（如 summerwind/actions-runner 镜像）上执行预提交检查工作流时，用户遇到了间歇性的性能问题。具体表现为 Post Setup 步骤异常缓慢，每个步骤耗时约 2 分 12 秒（误差在 1 秒内）。

技术分析

通过日志和网络抓包分析发现，虽然数据包（大小为数 MB）在几秒内就能完成传输，但随后与 GitHub 的连接会挂起，直到可能触发了超时机制。远程 IP 地址指向 Microsoft 的服务器（20.246.192.124）。

根本原因

这个问题与 Node.js 20 版本中的一个已知缺陷有关。该缺陷会导致在某些网络条件下，HTTP 连接无法正常关闭，从而造成延迟。具体表现为：

1. 数据传输完成后，TCP 连接未能及时释放
2. 系统等待超时后才继续执行后续步骤
3. 每次缓存操作都会重复这一过程

解决方案

经过实践验证，有以下几种可行的解决方案：

1. 升级缓存动作版本：将 actions/cache@v3 升级到 actions/cache@v4 可以解决此问题。v4 版本对底层实现进行了优化，避免了 Node.js 20 的这个缺陷。

2. 同时升级相关动作：建议将 actions/checkout 也升级到 v3 版本，确保整个工作流使用的动作版本相互兼容。

3. 临时替代方案（如果无法立即升级）：

   • 在自托管运行器上降级 Node.js 版本
   • 调整网络配置以减少连接超时时间
   • 使用更小的缓存分区

最佳实践建议

1. 定期检查并更新 GitHub Actions 中使用的工作流动作版本
2. 对于自托管运行器，确保运行环境与 GitHub 托管运行器保持兼容
3. 对于关键工作流，考虑实现缓存分层策略，减少单次缓存操作的数据量
4. 监控工作流执行时间，建立性能基准以便快速发现问题

结论

GitHub Actions 缓存性能问题通常可以通过升级到最新版本的动作来解决。actions/cache@v4 不仅修复了这个特定的性能问题，还可能包含其他性能优化和安全改进。对于依赖缓存功能的工作流，保持动作版本更新是确保稳定性和性能的最佳实践。