Jenkins阶段间变量传递失败求助：env.list无法跨阶段共享

你的问题源于两个核心问题：

1. Jenkins环境变量的类型限制：env对象仅支持存储字符串类型，直接将列表赋值给env.list会被自动转为字符串（比如["a","b"]变成"[a,b]"），导致阶段2无法通过数组索引访问元素。
2. 局部变量的作用域限制：阶段1中定义的var是script块内的局部变量，仅在当前阶段的上下文有效，阶段2中var未定义，调用var.mymethod2会直接报错。

解决方案分两种场景处理： #

场景1：所有阶段在同一个Agent上运行 #

这种情况下可以用全局变量跨阶段共享数据和脚本对象，最简单直接：

// 定义全局变量，让所有stage可见
def var
def globalList

environment {
  var1 = "city1"
  var2 = "city2"
}
stages{
  stage('stage 1 - define a var and load a script') {
    steps {
      script {
        var = load 'jenkins/methods.groovy'
        // 用全局变量存储列表，避开env的字符串限制
        globalList = var.mymethod(var1)
      }
    }
  }
  stage('stage 2 - use defined stuff in stage1') {
    steps {
      script {
        // 直接使用全局变量里的列表和脚本对象
        var.mymethod2(globalList[1], globalList[0])
      }
    }
  }
}

场景2：阶段在不同Agent上运行 #

不同Agent之间无法共享内存中的全局变量，需要用文件序列化+ stash 传递：

environment {
  var1 = "city1"
  var2 = "city2"
}
stages{
  stage('stage 1 - define a var and load a script') {
    agent { label 'agent-1' }
    steps {
      script {
        def var = load 'jenkins/methods.groovy'
        def tempList = var.mymethod(var1)
        // 将列表序列化为JSON文件
        writeJSON file: 'city-list.json', json: tempList
        // 暂存文件到Jenkins服务器
        stash includes: 'city-list.json', name: 'city-data'
      }
    }
  }
  stage('stage 2 - use defined stuff in stage1') {
    agent { label 'agent-2' }
    steps {
      script {
        // 重新加载脚本（每个Agent上下文独立）
        def var = load 'jenkins/methods.groovy'
        // 从Jenkins服务器取出暂存的文件
        unstash 'city-data'
        // 解析JSON文件恢复列表
        def list = readJSON file: 'city-list.json'
        var.mymethod2(list[1], list[0])
      }
    }
  }
}

关键注意点 #

• 永远不要用env存储非字符串类型的数据，复杂类型必须先序列化（JSON是最常用的方式）。
• 跨Agent共享数据只能通过文件、stash或外部存储（如数据库）实现，内存变量无法跨Agent传递。
• 加载的脚本对象var如果需要跨阶段使用，要么全局定义（同Agent），要么在每个阶段重新加载（不同Agent）。

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