GitHub Actions使用容器时无法命中缓存问题求助

问题描述 #

我有一个用于构建软件的GitHub Action，已配置缓存构建所需的工具agbcc以节省后续运行时间，在ubuntu-latest环境下运行正常，配置如下：

jobs:
  build:
    runs-on: ubuntu-latest

    steps:

      # installs the apt packages from a cache, speeding up the process substantially
      - name: Install Compiler
        run: sudo apt-get update && sudo apt-get install -y binutils-arm-none-eabi gcc-arm-none-eabi

      - name: Cache Tools
        uses: actions/cache@v3
        id: tools
        with:
          path: |
            tools/agbcc
          key: ${{ runner.os }}-tools


      # build and install agbcc into the tools directory
      - name: Clone agbcc
        if: steps.tools.outputs.cache-hit != 'true'
        uses: actions/checkout@master
        with:
          path: 'tmp/agbcc'
          repository: 'pret/agbcc'

      - name: Build agbcc
        if: steps.tools.outputs.cache-hit != 'true'
        run: |
          ./build.sh
          ./install.sh $GITHUB_WORKSPACE
        working-directory: tmp/agbcc

我创建了另一个配置完全相同的Action，仅添加了container: devkitpro/devkitarm:latest，且运行在同一分支。但容器环境下的Action无法找到缓存，我无法确定原因——它运行在同一分支、同一操作系统，理论上应该能命中缓存。请问该问题是否可解决，或是actions/cache在容器环境下存在限制？

原因分析 #

核心问题是缓存键的生成逻辑与容器环境不匹配：

• runner.os变量在主机环境（ubuntu-latest）取值为Linux，但在容器内部，该变量的取值取决于容器镜像的底层操作系统。devkitpro/devkitarm镜像的OS可能与主机Ubuntu存在差异，导致生成的缓存键看似一致，实则因为环境上下文（容器vs主机）的区别，无法匹配之前主机环境生成的缓存。
• actions/cache本身支持容器环境，但缓存匹配依赖完全一致的缓存键，以及容器内路径与主机路径的映射一致性。

解决办法 #

1. 调整缓存键，脱离runner.os依赖 #

将缓存键改为固定标识或结合容器镜像相关信息，确保容器环境的缓存键能精准匹配：

# 固定标识，仅针对容器环境的缓存
key: devkitarm-agbcc-tools
# 或者结合镜像相关文件哈希，避免镜像更新后复用旧缓存
key: devkitarm-${{ hashFiles('.github/workflows/your-build-workflow.yml') }}-agbcc-tools

2. 验证容器内路径一致性 #

确保容器内的GITHUB_WORKSPACE路径与主机环境一致，actions/cache会自动处理容器路径映射，但需确认tools/agbcc在容器内的存在路径与配置一致。可在缓存步骤后添加检查：

- name: Check Cache Status
  run: ls -la $GITHUB_WORKSPACE/tools/agbcc || echo "Cache not restored"

3. 修复缓存权限问题 #

容器内运行的用户可能与主机用户不同，导致缓存恢复时无法写入文件。可在缓存命中后添加权限修复步骤：

- name: Fix Cache Permissions
  if: steps.tools.outputs.cache-hit == 'true'
  run: sudo chown -R $USER:$USER tools/agbcc

4. 通过日志确认缓存状态 #

在GitHub Action的运行日志中，找到Cache Tools步骤的输出，查看是否有Cache hit occurred或No cache found for input keys的提示，直接确认缓存是否被正确匹配。

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