Windows10 WSL2环境下mvn spring-boot:build-image执行失败求助

错误提示显示无法找到docker.io/paketobuildpacks/builder:base镜像，核心原因是Spring Boot Maven插件的Buildpacks功能无法拉取到指定的构建镜像，具体可能的原因及解决办法如下：

1. Paketo Builder镜像标签或版本兼容问题 #

Spring Boot 2.7.x版本的spring-boot-maven-plugin默认使用的Paketo Builder镜像标签可能已被废弃或路径变更。Paketo的base标签可能不再指向有效镜像，或者需要指定更具体的版本。

解决办法：

• 手动拉取最新的兼容版镜像：

  docker pull paketobuildpacks/builder:base-platform-api-0.3
  

• 或者在插件配置中明确指定兼容的builder镜像：

  <configuration>
      <image>
          <name>alishahzad93/ccmp-${project.artifactId}:${project.version}</name>
      </image>
      <pullPolicy>IF_NOT_PRESENT</pullPolicy>
      <builder>paketobuildpacks/builder:base-platform-api-0.3</builder>
  </configuration>
  

2. 网络拉取失败 #

WSL2环境下可能存在网络访问限制（比如国内网络无法直接访问Docker Hub），导致镜像拉取超时或失败，最终返回404错误。

解决办法：

• 手动尝试拉取镜像，确认网络是否正常：

  docker pull paketobuildpacks/builder:base
  

  如果拉取失败，配置Docker镜像加速器（比如阿里云、网易镜像源），在Docker Desktop的设置中添加镜像加速地址后重启Docker。

3. PullPolicy设置限制 #

当前配置的pullPolicy为IF_NOT_PRESENT，如果本地镜像缓存中没有该镜像，可能因拉取过程中的静默错误导致未获取到镜像，却仍尝试使用本地不存在的镜像。

解决办法：

• 修改pullPolicy为ALWAYS，强制插件每次拉取最新镜像：

  <pullPolicy>ALWAYS</pullPolicy>
  

• 或者先手动拉取镜像到本地，再执行构建命令。

4. Docker API版本不兼容 #

错误中调用的是Docker API v1.24，而你使用的Docker 24.0.5对应的API版本更高（v1.43），Spring Boot Maven插件2.7.16可能与高版本Docker API存在兼容性问题。

解决办法：

• 升级spring-boot-maven-plugin到2.7.x系列的最新版本（比如2.7.17），该版本已修复部分Docker API兼容问题：

  <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <version>2.7.17</version>
      <!-- 其他配置 -->
  </plugin>
  

• 或者确认WSL2中Docker客户端与Docker Desktop的版本一致，避免版本不匹配导致的API调用问题。

额外检查 #

在WSL2终端中执行docker info，确认Docker引擎连接正常，且能正常拉取其他公共镜像（比如docker pull ubuntu），排除Docker环境本身的问题。

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