使用com.spotify:dockerfile-maven-plugin推送Docker镜像失败求助

我碰到过不少开发者在使用这个1.3.6版本插件推送镜像时踩过权限拒绝的坑，咱们一步步来排查解决：

1. 先确认本地Docker Hub登录状态 #

插件推送镜像依赖本地的Docker登录凭证，先确保你已经正确登录Docker Hub。执行以下命令重新登录试试：

docker login -u YOUR_DOCKER_HUB_USERNAME

输入密码后，确认登录成功提示。如果之前登录过但凭证过期，重新登录是最直接的第一步。

2. 检查镜像名称格式是否正确 #

Docker Hub的镜像必须遵循 <你的Docker Hub用户名>/<镜像名>:<标签> 的格式，比如 kaspartr/demo:latest。如果你的插件配置里镜像名没带用户名前缀，Docker会默认认为你要推送到官方仓库，自然会被拒绝访问。

打开pom.xml检查插件的<imageName>配置：

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>dockerfile-maven-plugin</artifactId>
    <version>1.3.6</version>
    <configuration>
        <imageName>kaspartr/demo:${project.version}</imageName>
        <dockerfile>Dockerfile</dockerfile>
    </configuration>
</plugin>

务必保证<imageName>开头是你自己的Docker Hub用户名。

3. 针对1.3.6版本的已知bug处理 #

这个版本确实存在凭证处理相关的bug，有两个实用的临时解决办法：

• 手动指定Docker配置文件路径：在插件配置里添加<dockerConfig>指向你的Docker配置文件（通常在~/.docker/config.json）：

  <configuration>
      <!-- 其他原有配置 -->
      <dockerConfig>${user.home}/.docker/config.json</dockerConfig>
  </configuration>
  

• 升级插件版本：如果项目允许，直接升级到1.4.13版本（这个版本修复了大量凭证相关问题），修改pom.xml里的<version>即可：

  <version>1.4.13</version>
  

4. 确认Docker Hub仓库的权限 #

如果你是推送到组织仓库，要确认你的账号被添加为仓库成员并拥有写权限；如果是个人仓库，确保仓库是你自己创建的，没有被设置为私有且权限受限。

5. 清理缓存后重试 #

有时候本地缓存会干扰推送流程，试试以下操作：

• 删除本地对应镜像：docker rmi kaspartr/demo:latest（替换成你的镜像名）
• 清理Maven插件缓存：mvn clean install -U
• 重新执行推送命令：mvn dockerfile:push

如果以上步骤都试过还是没解决，可以把你的pom.xml插件配置和Dockerfile内容贴出来，我再帮你进一步排查细节。

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