Gradle exec块未使用传入环境：指定npm版本构建失败求助

问题分析 #

你当前的两种写法存在以下问题：

• 第一种写法通过environment = pathEnvironment直接覆盖了所有环境变量，仅保留了PATH，导致npm执行时缺少其他必要的系统环境变量（如用户目录、系统库路径等），进而引发错误。
• 第二种写法虽然用environment(key, value)的方式追加PATH，但在Gradle 5.4.1中，这种方式可能没有正确合并原有环境变量，或者Jenkins运行环境中原有PATH的优先级更高。

解决方案 #

方案1：复制原有环境变量并修改PATH #

先获取当前系统的所有环境变量副本，再修改PATH后赋值给exec块，确保保留所有必要的环境变量：

// 复制当前所有环境变量
def fullEnv = System.getenv().collectEntries()
// 将目标Node/bin目录添加到PATH最前端，确保优先使用指定版本的npm
fullEnv["PATH"] = "/scratch/jenkins/.nvm/versions/node/v16.18.1/bin:" + fullEnv["PATH"]

exec {
    environment = fullEnv
    workingDir workspaceLocation
    commandLine "npm", "install"
}

方案2：直接指定npm的绝对路径 #

跳过PATH设置，直接调用目标版本npm的绝对路径，避免环境变量冲突：

exec {
    workingDir workspaceLocation
    // 直接使用指定版本npm的完整路径
    commandLine "/scratch/jenkins/.nvm/versions/node/v16.18.1/bin/npm", "install"
}

方案3：利用Jenkins的nvm插件简化版本切换 #

在Jenkins中安装nvm插件后，在构建步骤中先切换到目标Node版本，再执行Gradle构建。此时Gradle的exec块会自动使用激活的Node/npm版本，无需手动设置PATH：

Jenkins流水线示例：

pipeline {
    agent any
    stages {
        stage('Setup Node') {
            steps {
                script {
                    nvm('v16.18.1')
                }
            }
        }
        stage('Build with Gradle') {
            steps {
                sh './gradlew build'
            }
        }
    }
}

验证建议 #

可以在exec块中先执行echo $PATH或which npm命令，验证路径是否正确：

exec {
    environment = fullEnv
    workingDir workspaceLocation
    commandLine "bash", "-c", "echo \$PATH && which npm"
}

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