GitLab中Kotlin项目Gradle任务输出无法复用的问题排查

你遇到的核心问题是：Gradle的任务增量判断不是仅依赖输出文件是否存在，而是基于任务的输入、输出文件的内容哈希和元数据（如修改时间）来决定是否标记为UP-TO-DATE。即使GitLab缓存恢复了build目录下的文件，以下两个关键因素会导致jar任务重新执行：

1. 缓存恢复后的文件元数据变化
   GitLab CI在恢复缓存时，会重置文件的修改时间（mtime）为缓存恢复的时间，而非原文件的修改时间。Gradle会将文件的mtime作为增量判断的依据之一，当mtime变化时，即使文件内容完全一致，Gradle也会认为输入/输出状态发生了改变，从而重新执行任务。

2. Jar任务的输入依赖未被正确识别为未变更
   jar任务的输入不仅包括classes目录（该目录被标记为UP-TO-DATE），还可能包含：

• 项目的构建配置文件（如build.gradle.kts）
• Jar清单文件（默认生成的MANIFEST.MF）
• 其他参与Jar打包的资源或配置

如果这些输入的元数据（比如MANIFEST.MF的生成时间）在缓存恢复后发生了变化，也会触发jar任务重新执行。

方案1：使用Gradle官方构建缓存（推荐） #

Gradle自带的构建缓存是专门为增量构建设计的，比GitLab的通用文件夹缓存更适配Gradle的任务判断逻辑。配置步骤如下：

1. 在项目根目录的settings.gradle.kts中添加远程构建缓存配置：

buildCache {
    // CI环境为全新容器，关闭本地缓存
    local {
        enabled = false
    }
    // 配置GitLab CI的远程构建缓存
    remote<HttpBuildCache> {
        url = uri(System.getenv("CI_PROJECT_URL") + "/-/ci/builds/")
        credentials {
            username = System.getenv("CI_JOB_TOKEN")
            password = System.getenv("CI_JOB_TOKEN")
        }
        // 仅在主分支推送缓存，其他分支仅拉取
        push = System.getenv("CI_COMMIT_BRANCH") == "main"
    }
}

2. 修改GitLab CI配置（.gitlab-ci.yml），移除对build目录的缓存，仅保留Gradle依赖缓存：

stages:
  - build

build:
  stage: build
  image: gradle:7.5.1-jdk17
  variables:
    GRADLE_OPTS: "-Dorg.gradle.daemon=false"
  cache:
    key: global-cache
    paths:
      - /home/gradle/.gradle
  script:
    - gradle -version
    - gradle build --console=plain --build-cache
  artifacts:
    paths:
      - build/libs/*.jar
    reports:
      junit:
        - build/test-results/test/TEST-*.xml
    expire_in: 1 week
    when: always

方案2：修复GitLab缓存的文件元数据问题 #

如果你坚持使用GitLab的文件夹缓存，可以在恢复缓存后，手动同步文件的修改时间，让Gradle识别到文件状态未变更：

在CI脚本中添加touch命令，更新build目录下文件的修改时间：

script:
  - ls build/libs
  # 同步build目录下所有文件的修改时间，避免mtime变化导致Gradle误判
  - find build -type f -exec touch {} +
  - gradle -version
  - gradle build --console=plain

方案3：调试Jar任务的增量判断逻辑 #

执行gradle jar --info命令，Gradle会输出详细的增量判断日志，你可以从中看到哪个输入/输出文件的哈希值发生了变化，从而精准定位问题：

gradle jar --info

日志中会包含类似以下的内容，展示任务输入的哈希计算结果：

Task ':jar' is not up-to-date because:
  Input property 'manifest' file /build/tmp/jar/MANIFEST.MF has changed.

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