Azure Pipeline Cache@2任务缓存Go包失败求助

核心原因分析 #

出现报错的关键原因有两个：

• 目标目录未提前创建：首次运行时，go test 执行前 /go/pkg/mod 目录不存在，Cache@2 任务在尝试保存缓存时找不到路径，触发 tar 错误。
• 权限或路径配置问题：容器环境中，/go/pkg/mod 可能由 root 用户创建，Agent 运行用户无读写权限；或者硬编码路径不符合实际模块缓存路径（比如 GOMODCACHE 环境变量已修改）。

分步解决方案 #

1. 动态获取模块缓存路径 #

避免硬编码路径，直接使用 Go 内置的 GOMODCACHE 环境变量，确保路径与当前 Go 环境一致：

- task: Cache@2
  inputs:
    key: 'go | $(Agent.OS) | $(hashFiles(''**/go.mod''))'
    path: $(GOMODCACHE)
    restoreKeys: |
       go | $(Agent.OS)
       go
- script: go test ./...

注：hashFiles('**/go.mod') 会计算所有 go.mod 文件的哈希值，确保依赖变更时自动更新缓存。

2. 提前创建目录并修复权限 #

在缓存任务前添加脚本，确保目标目录存在且 Agent 用户有读写权限：

- script: |
    # 打印当前模块缓存路径，确认配置
    echo "Current GOMODCACHE: $GOMODCACHE"
    # 创建目录并授权给当前用户
    mkdir -p "$GOMODCACHE"
    chown -R "$(whoami):$(whoami)" "$GOMODCACHE"
    # 验证目录状态
    ls -ld "$GOMODCACHE"
  displayName: Prepare Go module cache directory
- task: Cache@2
  inputs:
    key: 'go | $(Agent.OS) | $(hashFiles(''**/go.mod''))'
    path: $(GOMODCACHE)
    restoreKeys: |
       go | $(Agent.OS)
       go
- script: go test ./...

3. 验证缓存流程 #

添加日志脚本，确认依赖下载和缓存保存的状态：

- script: go mod download && go list -m all
  displayName: Pre-download dependencies and verify

执行该脚本后，GOMODCACHE 目录会被填充依赖，确保 Cache@2 任务保存缓存时能找到有效路径。

额外注意事项 #

• 容器环境中，若使用自定义镜像，需确认镜像已安装 Go 且 GOMODCACHE 变量正确配置。
• 若 Agent 运行在 root 用户下，可跳过权限修复步骤，但不推荐在生产环境使用 root 运行构建任务。

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