Jenkins构建镜像推送Docker Hub失败：登录成功仍遭权限拒绝

安全阿岳

2026-6-21

问题分析与解决方案

核心问题

你遇到的denied: requested access to the resource is denied错误，根源在于三个关键问题：

sudo导致用户上下文不匹配：登录Docker Hub的是jenkins用户，但推送时用sudo docker push切换到了root用户，root没有对应的登录凭据
Jenkins Docker插件用法错误：docker.withRegistry块内未使用插件的推送API，而是直接调用shell命令，等于未利用插件的认证能力
仓库用户名不一致：你提到为用户harsha330创建了仓库，但推送的镜像标签是harsha3330/mocktest-frontend，用户名不匹配会触发权限验证失败

具体修复步骤

1. 修正仓库用户名匹配

确保镜像标签的用户名和Docker Hub仓库的用户名完全一致：

dockerImage = "harsha330/mocktest-frontend:${env.FrontendBranch}-${BUILD_NUMBER}-date-${BUILD_TIMESTAMP}-dev"

2. 移除sudo，统一用户上下文

给jenkins用户添加docker执行权限（执行sudo usermod -aG docker jenkins后重启Jenkins），然后移除命令中的sudo：

sh "docker build -f applications/mocktest-frontend/Dockerfile -t mocktest-frontend ."
sh "docker tag mocktest-frontend:latest ${dockerImage}"

3. 正确使用Jenkins Docker插件推送

docker.withRegistry块内要使用插件提供的推送方法，自动处理认证逻辑：

// 直接构建并打目标标签，省略中间tag步骤
sh "docker build -f applications/mocktest-frontend/Dockerfile -t ${dockerImage} ."

// 用Docker插件完成认证与推送
docker.withRegistry('https://index.docker.io/v1/', registryCredential) {
    def image = docker.image(dockerImage)
    image.push()
}