Jenkins 2.361.2：Jenkinsfile流水线动态变量定义失败求助

问题根源 #

你的问题核心在于Declarative Pipeline与Scripted Pipeline的变量作用域差异，以及环境变量的赋值方式不符合Declarative语法要求：

• 直接在environment块中调用函数，Declarative会将其视为静态字符串而非Groovy代码执行；
• 全局Groovy变量在script块外的声明式steps中无法被正确访问；
• 直接调用函数能输出正确值，是因为echo中的+运算符触发了Groovy表达式解析，而单独引用变量时未满足作用域要求。

修复方案 #

方案1：正确使用Declarative的environment块 #

在environment块中通过Groovy字符串插值${}执行函数，确保函数逻辑被触发并返回结果：

def determineProjectByBranch(branchName) {
  String projectName = "";

  if (branchName.contains("api")) {
    projectName = "api";
  } else if (branchName.contains("auth")) {
    projectName = "auth";
  }

  return projectName;
}

pipeline {
  agent any

  stages {
    stage("Build") {
      environment {
        // 用${}包裹函数调用，触发Groovy代码执行
        PROJECT_NAME = "${determineProjectByBranch(GIT_BRANCH)}"
      }

      steps {
        echo "branch name: ${GIT_BRANCH}"
        echo "project name: ${PROJECT_NAME}"
        sh "chmod +x gradlew"
        sh "./gradlew ${PROJECT_NAME}:clean ${PROJECT_NAME}:build"
      }
    }
  }
}

方案2：统一在script块内处理变量逻辑 #

将变量的赋值与后续使用全部放在script块中，确保变量在同一Scripted作用域内被访问：

def determineProjectByBranch(branchName) {
  String projectName = "";

  if (branchName.contains("api")) {
    projectName = "api";
  } else if (branchName.contains("auth")) {
    projectName = "auth";
  }

  return projectName;
}

def projectName

pipeline {
  agent any

  stages {
    stage("Build") {
      steps {
        script {
          projectName = determineProjectByBranch(GIT_BRANCH)
          echo "branch name: ${GIT_BRANCH}"
          echo "project name: ${projectName}"
          sh "chmod +x gradlew"
          sh "./gradlew ${projectName}:clean ${projectName}:build"
        }
      }
    }
  }
}

关键说明 #

• Jenkins 2.361.2的Declarative Pipeline对environment块的语法要求严格，必须通过插值语法执行动态逻辑；
• 声明式steps中仅支持预定义的步骤语法，自定义Groovy变量的访问必须包裹在script块内；
• 避免混合使用声明式与脚本式语法的变量作用域，尽量保持逻辑块的一致性。

内容的提问来源于stack exchange，提问作者I have 10 fingers