GitLab CI缓存键有效仍重复上传缓存 如何实现仅失效时上传？

核心问题原因与解决方法 #

你遇到的重复上传缓存问题，核心原因是GitLab CI默认缓存策略为pull-push：每个任务执行前拉取缓存，执行后无论缓存是否命中、缓存键是否变化，都会触发上传逻辑。要实现仅缓存失效时才上传，可通过拆分缓存权限实现：

• 全局缓存默认设置为pull策略，所有业务任务仅拉取缓存，无上传权限
• 新增单独的依赖安装前置任务，仅该任务使用pull-push策略，作为唯一的缓存上传入口

参考配置如下：

# 全局缓存配置
cache:
  key:
    files:
      - package-lock.json
  paths:
    - node_modules/
    - .npm
  # 全局默认仅拉取缓存
  policy: pull

stages:
  - deps
  - build
  - test

# 唯一允许上传缓存的依赖安装任务
install-deps:
  stage: deps
  script:
    - npm ci
  cache:
    # 仅该任务覆盖为拉取+推送权限
    policy: pull-push
  # 可选配置：仅当package-lock.json变动时才执行该任务，进一步节省资源
  rules:
    - changes:
        - package-lock.json

# 后续所有业务任务默认继承全局pull策略，不会上传缓存
build-project:
  stage: build
  script:
    - npm run build

test-project:
  stage: test
  script:
    - npm run test

其他缓存优化建议 #

• 给缓存键增加分支前缀，避免不同分支的依赖缓存互相污染：

cache:
  key:
    files:
      - package-lock.json
    # 用分支名作为缓存键前缀
    prefix: $CI_COMMIT_REF_SLUG
  paths:
    - node_modules/
    - .npm

• 依赖安装统一使用npm ci代替npm install，完全对齐package-lock.json声明的版本，不会修改锁文件，避免缓存内容意外变更导致的重复上传
• 检查GitLab Runner配置，确认未开启DisableCache参数，同时缓存存储后端（本地磁盘、对象存储等）读写权限正常，避免缓存写入失败触发重复上传
• 自托管Runner可开启缓存增量上传功能，降低缓存上传的体积和耗时

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