Gradle缓存问题：Task.upToDateWhen为false但缓存键已存在

问题背景 #

我在调试Java/Scala项目的Gradle Test任务缓存问题，执行指定命令后，远程构建缓存已生成对应工件，但重复执行任务时，总会提示Task.upToDateWhen is false并重新运行测试。我未在Gradle配置文件中找到特殊的测试配置，需要排查该问题的原因。

执行的Gradle命令 #

./gradlew build --no-daemon --info --stacktrace --build-cache -Dorg.gradle.caching.debug=true

目标任务输出 #

Build cache key for task ':kafka-utils:test' is 803214d05e5842edc7b3e239f8fe08da
Task ':kafka-utils:test' is not up-to-date because:
Task.upToDateWhen is false.
... (Tests omitted for brevity)
Stored cache entry for task ':kafka-utils:test' with cache key 803214d05e5842edc7b3e239f8fe08da

GitHub Actions工作流配置 #

jobs:
  build:
    runs-on: ubuntu-20.04
    permissions:
      contents: read
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Set up JDK
        uses: actions/setup-java@v3.13.0
        with:
          java-version: '17'
          distribution: 'temurin'

      - name: Setup Gradle
        uses: gradle/gradle-build-action@v2.8.1
        with:
          cache-read-only: false

      - name: Gradle build
        env:
          ARTIFACTORY_USER: xxx
          ARTIFACTORY_KEY: xxx
        run: ./gradlew build --no-daemon --info --stacktrace --build-cache -Dorg.gradle.caching.debug=true

排查步骤 #

• 检查隐性upToDateWhen配置：即便本地配置中没有设置，也可能是第三方插件、自定义插件或父级Gradle脚本（如buildSrc、根项目build.gradle）中添加了upToDateWhen { false }逻辑。添加--debug参数运行命令，搜索日志中upToDateWhen相关的配置来源。
• 验证任务输入输出稳定性：Test任务的输入包含代码、系统属性、环境变量、测试资源等。执行./gradlew :kafka-utils:test --dry-run --info查看任务输入快照，对比两次执行的输入是否存在差异。
• 确认Gradle版本兼容性：本地和远程缓存使用的Gradle版本需一致，不同版本Gradle生成的缓存键可能不兼容，导致无法命中缓存。
• 检查测试任务自定义逻辑：排查是否通过doFirst/doLast添加了动态逻辑，或未正确声明任务outputs，这些都会影响upToDateWhen的判断。
• 排查GHA环境差异：每次GHA运行的环境可能存在临时文件、系统变量等细微差异。可在工作流中添加步骤打印环境变量，对比两次运行的环境；也可在本地模拟GHA环境执行任务，验证是否复现问题。

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