如何在Gradle任务中处理npm的非零退出码？

要实现统一前后端代码检查的pre-commit任务，同时自定义前端npm run lint的错误提示，你可以通过以下两种方式处理：

方法一：基于Gradle Exec任务改造 #

利用Gradle的Exec任务类型，通过设置ignoreExitValue禁用默认的异常抛出，手动检查命令执行结果并输出自定义提示：

// 自定义前端Lint检查任务，依赖后端的spotlessCheck
task frontendLint(type: Exec) {
    dependsOn spotlessCheck
    // 指定命令执行的工作目录为spa
    workingDir file('spa')
    // 执行npm run lint命令
    commandLine 'npm', 'run', 'lint'
    // 允许命令非零退出，不自动抛出异常
    ignoreExitValue = true

    doLast {
        // 检查命令退出值
        if (execResult.exitValue != 0) {
            // 输出自定义提示
            println '\n' + '*' * 60
            println '⚠️ 前端代码检查未通过！请修复ESLint报错后再提交代码。'
            println '*' * 60 + '\n'
            // 抛出异常终止任务，阻止pre-commit提交
            throw new GradleException('前端Lint检查失败')
        }
    }
}

// 若使用gradle-pre-commit-plugin，将任务加入pre-commit钩子
preCommit {
    tasks = [frontendLint]
}

为什么之前的try-catch无效？ #

Gradle的Exec任务默认会在命令返回非零值时抛出StopExecutionException，这个异常会在任务执行流程中被Gradle框架捕获处理，而非进入你写的try-catch块。设置ignoreExitValue = true后，任务会跳过自动异常抛出，将执行结果存入execResult，你就能在doLast中手动处理。

方法二：使用ProcessBuilder完全控制进程 #

如果需要更灵活的进程控制（比如实时输出日志、自定义流处理），可以直接用Java的ProcessBuilder执行命令：

task frontendLint {
    dependsOn spotlessCheck
    doLast {
        def processBuilder = new ProcessBuilder('npm', 'run', 'lint')
            // 设置工作目录
            .directory(file('spa'))
            // 将错误流合并到标准输出，统一打印
            .redirectErrorStream(true)
        
        def process = processBuilder.start()
        // 实时输出命令执行日志
        process.inputStream.eachLine { line -> println line }
        // 等待命令执行完成
        process.waitFor()

        if (process.exitValue() != 0) {
            println '\n' + '*' * 60
            println '⚠️ 前端代码检查未通过！请修复ESLint报错后再提交代码。'
            println '*' * 60 + '\n'
            throw new GradleException('前端Lint检查失败')
        }
    }
}

这种方式完全脱离Gradle Exec任务的默认行为，所有进程逻辑由你自行控制，避免框架层面的异常拦截。

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