为何Jenkins共享库env对象在Docker化阶段更新HOME变量时未同步？

在Jenkins共享库中使用env对象时，会遇到这样的现象：env.HOME的值不会随Docker化阶段更新，但执行shell步骤时，HOME却能指向容器内的正确值。比如预期env.HOME == sh(script:'echo $HOME', returnStdout: true).trim()成立，这个等式在普通agent阶段符合预期，但在Docker化阶段却不成立。

已知解决方法（比如用withEnv手动设置、在shell中直接用~或$HOME获取），下面解释该现象的核心原因：

代码示例 #

共享库文件 /vars/foo.groovy #

def info() {
 println "Stage: ${env.STAGE_NAME}, env.HOME: ${env.HOME}"
 sh 'echo HOME=$HOME'
}

Jenkinsfile #

...
stages {
  stage('agent') {
   steps {
     script { foo.info() }
   }
  }
  stage('dockerized') {
    agent {
      docker {
        image runnerImage
        reuseNode true
      }
    }
    steps {
      script { foo.info() }
    }
  }
}

执行结果 #

Stage: agent, HOME: /home/ec2-user
echo HOME=/home/ec2-user
 HOME=/home/ec2-user

Stage: dockerized, HOME: /home/ec2-user
echo HOME=/home/jenkins
 HOME=/home/jenkins

原因解析 #

核心在于Jenkins Pipeline中Groovy运行时的env对象与Docker容器环境的隔离机制：

• Groovy层的env对象初始化时机：当Pipeline在agent节点启动时，Jenkins会在节点宿主环境中初始化Groovy运行时，此时env对象会加载宿主环境的所有环境变量（包括HOME=/home/ec2-user），这个env对象会在整个Pipeline复用节点的过程中保持不变。
• Docker容器的环境隔离：使用reuseNode: true的Docker agent阶段，是在已有的节点Groovy运行时上启动Docker容器，容器作为独立的子进程运行，拥有自己的环境变量空间，但Groovy层的env不会自动同步容器内的环境变量，因此env.HOME仍然是宿主节点的旧值。
• Shell步骤的环境特性：sh步骤是直接在Docker容器的shell进程中执行命令，shell会加载容器自身的环境配置，因此能正确获取容器内的HOME=/home/jenkins。

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