GitHub Actions执行lint任务报getCacheEntry failed 503错误如何修复

在GitHub Actions中运行Python代码lint检查工作流时，配置了pip依赖缓存的Job执行失败，抛出错误：getCacheEntry failed: Cache service responded with 503
使用的工作流配置如下：

lint:
  name: Lint
  runs-on: ubuntu-latest
  steps:
    - name: Checkout
      uses: actions/checkout@v3
    - name: Set up Python
      uses: actions/setup-python@v4
      with:
        python-version-file: '.python-version'
        cache: 'pip'
        cache-dependency-path: 'requirements.txt'

该错误属于GitHub Actions缓存服务侧异常，和仓库内的业务代码、lint规则逻辑无关，常见触发场景：

• GitHub官方缓存服务临时负载过高、节点故障，属于偶发服务波动
• 仓库下存储的缓存条目过多、单缓存体积超出官方10GB的限制，触发服务端限流
• 低版本Action内置的缓存调用逻辑存在已知兼容缺陷

按优先级从高到低操作即可：

• 直接重跑失败的工作流：90%以上的该类报错为临时服务波动，无需修改任何配置，在Actions页面重跑对应Job即可恢复正常。
• 重试无效时临时关闭缓存兜底：先注释掉setup-python中的缓存相关配置，优先保证流水线正常执行，等缓存服务恢复后再重新开启缓存，配置修改示例：

- name: Set up Python
  uses: actions/setup-python@v4
  with:
    python-version-file: '.python-version'
    # 缓存服务故障时临时注释以下两行绕过问题
    # cache: 'pip'
    # cache-dependency-path: 'requirements.txt'

• 升级Action到最新稳定版本：旧版本的actions/checkout、actions/setup-python内置的缓存逻辑存在兼容问题，升级到最新稳定版可解决固定复现的503报错，配置修改示例：

- name: Checkout
  uses: actions/checkout@v4
- name: Set up Python
  uses: actions/setup-python@v5
  with:
    python-version-file: '.python-version'
    cache: 'pip'
    cache-dependency-path: 'requirements.txt'

• 清理仓库冗余缓存：如果该问题频繁复现，进入仓库Actions菜单下的Caches管理页面，删除过期、体积异常偏大的旧缓存条目，避免触发服务端限流。
• 确认官方服务状态：如果以上操作都无效，查看GitHub官方服务状态页，若Actions缓存模块标记为故障，等待官方修复即可，无需自行调整配置。

内容的提问来源于stack exchange，提问作者Divya Shrestha