Jenkins中Docker Build and Publish步骤报构建失败异常如何解决

该异常是Docker Build and Publish插件在处理镜像仓库认证信息时解析空对象触发的，核心诱因有三类：

1. Docker镜像仓库凭证配置错误：插件读取你配置的Registry认证信息时拿到了空值，可能是凭证填写错误、引用的凭证ID不对，或者Registry地址格式不符合插件要求
2. 插件版本不兼容：你安装的CloudBees Docker Build and Publish插件与Docker Commons插件版本不匹配，低版本插件无法正确解析新版Docker Registry返回的认证结构
3. Docker执行权限不足：运行Jenkins进程的用户没有Docker服务的调用权限，插件调用Docker命令返回空结果，解析时触发空对象异常

按以下步骤依次排查修复：

• 校验Docker Registry配置
  1. 进入Jenkins全局凭证管理，确认你配置的Docker镜像仓库凭证类型为Username with password，用户名、密码（Docker Hub建议使用个人访问令牌代替密码）填写正确
  2. 进入对应任务的Docker Build and Publish配置页，确认Registry URL格式正确：Docker Hub需填写https://index.docker.io/v1/，不可省略前缀和后缀路径；确认下拉选择的凭证是之前校验过的正确凭证
• 升级相关依赖插件
  进入Jenkins插件管理页面，将Docker Commons Plugin和CloudBees Docker Build and Publish plugin升级到最新稳定版，升级完成后重启Jenkins生效
• 配置Docker执行权限
  登录Jenkins部署的服务器，执行以下命令检查jenkins用户的用户组：

  groups jenkins
  

  如果输出结果中没有docker用户组，执行以下命令添加权限并重启Jenkins：

  sudo usermod -aG docker jenkins
  sudo systemctl restart jenkins
  

  完成后重新执行构建即可

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