Jenkins流水线Docker登录失败：MissingPropertyException报错求助

错误原因：USER变量解析错误 #

你代码里的$USER在Groovy双引号字符串中会被当作Groovy变量解析，但Groovy上下文里没有这个变量，所以抛出MissingPropertyException。这里你想引用的是Shell环境中的当前用户变量，但Groovy的双引号会优先解析自身变量，导致失败。

解决方案步骤 #

1. 修复USER变量的写法 #

有两种可靠的方式：

• 使用单引号包裹Shell命令，这样Groovy不会解析内部的$符号，直接传递给Shell使用其环境变量：

  sh 'sudo usermod -aG docker $USER'
  

• 直接指定Jenkins Agent运行的用户（通常是jenkins），避免依赖Shell环境变量：

  sh "sudo usermod -aG docker jenkins"
  

2. 解决Docker权限不生效的问题 #

流水线中执行usermod -aG docker后，当前Jenkins进程不会自动加载新的用户组，所以这一步在流水线内执行后不会立即生效。正确的做法是：

• 在Jenkins Agent机器上手动执行一次：

  sudo usermod -aG docker jenkins
  sudo systemctl restart jenkins-agent  # 或重启Jenkins服务，取决于你的部署方式
  

  这样Jenkins用户就永久拥有Docker组权限，后续流水线无需再执行usermod命令。

• 如果无法提前配置Agent机器，可在Shell命令中临时切换用户组（需确保每个Docker命令都在该环境下执行）：

  sh 'newgrp docker && docker login --username ${USERNAME} --password ${PASSWORD} example.azurecr.io/test'
  sh 'newgrp docker && ./build image1'
  

3. 更安全的Docker登录方式（推荐） #

避免在Shell命令中直接暴露密码，使用Jenkins的withDockerRegistry插件自动处理登录：

pipeline {
    agent any

    stages {
        stage('Build Agent Image') {
            steps {
                dir('jenkins') {
                    withDockerRegistry([
                        url: 'https://example.azurecr.io/test',
                        credentialsId: 'acr-credential'
                    ]) {
                        sh "./build image1"
                    }
                }
            }
        }
    }
}

该方法会自动从凭据中获取账号密码完成Docker登录，无需手动编写docker login命令，更安全且不易出错。

4. 避免使用chmod 777 /var/run/docker.sock #

这个操作会把Docker套接字权限开放给所有用户，存在严重安全风险，相当于给所有用户Root权限，强烈不建议使用。

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