Docker Build and Publish构建步骤失败排查求助

核心排查方向 #

• 凭证配置校验
  错误栈指向DockerRegistryToken类，优先排查Docker仓库凭证问题：

  • 确认凭证类型为「Docker Registry Credentials」，而非普通用户名密码凭证
  • 在Jenkins节点上执行docker login <仓库地址> -u <用户名> -p <密码/令牌>，手动验证凭证有效性
  • 检查Job配置中是否正确选择了授权的凭证，确保凭证未过期

• 节点环境校验

  • 核对Jenkins节点的Docker版本与插件兼容范围（可查看插件官方文档）
  • 确认Jenkins用户拥有Docker操作权限：执行groups jenkins查看是否包含docker用户组
  • 测试节点与Docker仓库的网络连通性：执行curl <仓库地址>/v2/，确保返回200或401（未授权属于正常，说明网络可达）

• 插件依赖排查

  • 进入Jenkins「系统管理」→「插件管理」→「已安装」，检查Docker Commons Plugin、Docker Build and Publish Plugin等核心插件的版本兼容性，必要时回退至LTS稳定版本
  • 查看Jenkins系统日志，搜索DockerRegistryToken关键词，获取更详细的报错上下文

• Job配置细节检查

  • 确认「Docker Build and Publish」步骤中的仓库地址无拼写错误、多余斜杠
  • 检查镜像标签是否符合Docker规范，避免特殊字符
  • 私有仓库需确认域名、端口配置完整

极简验证测试 #

创建仅包含拉取基础镜像（如nginx:alpine）并推送至仓库的测试Job，排除业务代码或Dockerfile导致的问题

内容的提问来源于stack exchange，提问作者Mostafa abd elsamie