Gradle持续构建异常求助：编译成功后未触发文件更新

我使用Gradle 8.1和Groovy脚本编写了一个小型任务，希望配合--continuous参数运行，在compileJava任务成功执行后触发文件touch操作，但遇到了异常情况。

任务代码如下：

import java.time.Instant

tasks.register('continuous-build') {
    dependsOn tasks.compileJava
    onlyIf { !compileJava.state.upToDate }
    logger.lifecycle("Job executed at " + Instant.now())
    doLast {
        def file = new File(projectDir, "build/classes/java/main/.reloadTrigger");
        file.createNewFile();
        file.setLastModified(Instant.now().toEpochMilli())
        logger.lifecycle("This message is never seen")
    }
}

操作流程与异常现象：

1. 执行命令./gradlew continuous-build --continuous，构建成功后进入等待文件变更状态；
2. 修改Main.java并成功编译，文件时间戳正常更新（符合预期）；
3. 修改Main.java导致编译失败，文件时间戳未更新（符合预期）；
4. 再次修改Main.java并成功编译，但文件时间戳不再更新。

我的疑问：

• 为什么doLast块中的日志消息（This message is never seen）从未显示？
• 如何实现compileJava任务成功时稳定触发文件touch操作？

1. 日志未显示的原因 #

你在任务配置阶段直接调用了logger.lifecycle("Job executed at " + Instant.now())，这行代码会在Gradle初始化任务时就执行，而非任务运行阶段。而doLast里的日志没显示，核心原因是后续构建中你的任务被判定为UP-TO-DATE，直接跳过了doLast块的执行：

• 第一次运行时，compileJava非最新状态，任务通过onlyIf检查，执行doLast；
• 第二次修改后编译成功，compileJava被标记为UP-TO-DATE，你的任务因onlyIf { !compileJava.state.upToDate }的判断条件不满足，直接跳过执行，自然不会输出doLast里的日志。

2. 稳定触发touch操作的方案 #

要实现compileJava成功时触发touch，需放弃依赖upToDate状态的判断逻辑，改为监听任务执行结果或确保任务在目标场景下必执行。

方案一：直接给compileJava添加执行钩子 #

这是最简洁的方式，无需额外任务，直接在compileJava成功完成后执行touch：

import java.time.Instant

tasks.compileJava {
    doLast {
        def file = new File(projectDir, "build/classes/java/main/.reloadTrigger")
        file.createNewFile()
        file.setLastModified(Instant.now().toEpochMilli())
        logger.lifecycle("Touch operation executed successfully")
    }
}

只要compileJava成功执行（首次构建或变更后重新编译均适用），就会自动执行touch操作；编译失败时则不会触发。

方案二：修正自定义任务逻辑 #

若需保留continuous-build任务，需调整任务的状态判定规则，确保任务在compileJava成功时必执行：

import java.time.Instant

tasks.register('continuous-build') {
    dependsOn tasks.compileJava
    // 强制任务永远不被标记为UP-TO-DATE
    outputs.upToDateWhen { false }
    // 仅在compileJava成功执行后才运行当前任务
    onlyIf { tasks.compileJava.state.executed && tasks.compileJava.state.success }

    doLast {
        def file = new File(projectDir, "build/classes/java/main/.reloadTrigger")
        file.createNewFile()
        file.setLastModified(Instant.now().toEpochMilli())
        logger.lifecycle("Touch operation executed successfully")
    }
}

运行./gradlew continuous-build --continuous后，每次compileJava成功完成，该任务都会执行touch操作。

关键注意事项 #

• 不要在任务配置阶段编写业务逻辑（如你之前直接调用的logger.lifecycle），配置阶段代码会在Gradle每次初始化时执行，与任务是否运行无关；
• 判断任务是否成功执行，需结合executed和success状态，而非仅依赖upToDate——upToDate仅表示任务输出无变化，不代表任务是否实际执行过。

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