Jenkins共享库src类无法读取环境变量的解决方法咨询

这个问题我之前也碰到过，核心原因是Jenkins Pipeline的withEnv设置的是Pipeline执行上下文的环境变量，而非JVM进程级别的环境变量，所以src目录下的普通Groovy/Java类用System.getenv()是拿不到这些临时变量的。下面给你几个可行的解决方案：

方案1：直接传递需要的环境变量到类中 #

最简单的方式就是在var脚本里把能访问到的环境变量，作为参数传给src类的构造函数或方法：

修改后的共享库var/lib.groovy #

def displayEnv() { 
    println "Shared lib var/lib FOO=${FOO}" 
    // 把FOO变量传给MyClass的构造函数
    MyClass c = new MyClass(FOO) 
}

修改后的共享库src/MyClass.groovy #

class MyClass { 
    // 接收传递过来的环境变量值
    MyClass(String foo) { 
        throw new Exception("Shared lib src/MyClass FOO=${foo}")
    } 
}

方案2：传递整个Pipeline环境上下文对象 #

如果需要访问多个环境变量，一个个传太麻烦，可以直接把Pipeline的env对象传给类：

修改后的var/lib.groovy #

def displayEnv() { 
    println "Shared lib var/lib FOO=${FOO}" 
    // 传递env对象给MyClass
    MyClass c = new MyClass(env) 
}

修改后的src/MyClass.groovy #

class MyClass { 
    MyClass(def env) { 
        String foo = env.FOO
        throw new Exception("Shared lib src/MyClass FOO=${foo}")
    } 
}

为什么原来的方法不生效？ #

再补充下原理帮你理解：

• Jenkins Pipeline的withEnv是Pipeline DSL提供的功能，它只在Pipeline的执行上下文（比如Jenkinsfile、var目录下的脚本）中生效，这些地方的变量是Pipeline运行时维护的，不是真正写入到JVM进程的环境变量里。
• src目录下的类是普通的Groovy类，运行在Jenkins agent的JVM进程中，System.getenv()读取的是JVM进程启动时就存在的环境变量，自然拿不到Pipeline临时设置的FOO。

不推荐的方案：设置JVM进程级环境变量 #

如果你真的想让System.getenv()能读到，也可以通过修改JVM进程的环境变量实现，但这种方式会影响整个Jenkins agent节点上的所有任务，风险较高，不建议使用：

// 在Jenkinsfile里设置（会影响整个agent）
env.FOO = "BAR2"

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