GitLab CI/CD构建SpringBoot3原生镜像遇Docker API 400错误求解

针对本地构建正常、GitLab CI中调用Docker API返回400 Bad Request的问题，可按以下方向排查解决：

1. 对齐Docker客户端与服务端的API版本 #

Docker API v1.24属于较旧版本，当前多数Buildpacks构建器依赖更高版本的API支持：

• 在CI作业中先执行docker version，确认客户端和守护进程的版本差异。
• 在构建命令中显式指定兼容的API版本，例如对应Docker 20.10+的v1.41：

  mvn -U -Pnative spring-boot:build-image -DskipTests -Dspring-boot.build-image.docker-api-version=1.41
  

• 也可在pom.xml的Spring Boot插件中永久配置：

  <plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
      <dockerApiVersion>1.41</dockerApiVersion>
      <!-- 其他配置 -->
    </configuration>
  </plugin>
  

2. 显式指定Buildpacks构建器的稳定版本 #

避免使用latest标签带来的版本歧义，改用具体的稳定版本标签（可在Paketo官方渠道查询最新稳定版）：

• 命令行指定：

  mvn -U -Pnative spring-boot:build-image -DskipTests -Dspring-boot.build-image.builder=paketobuildpacks/builder-jammy-tiny:0.33.1
  

• 或在pom.xml中配置：

  <plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
      <builder>paketobuildpacks/builder-jammy-tiny:0.33.1</builder>
      <!-- 其他配置 -->
    </configuration>
  </plugin>
  

3. 调整GitLab CI的Docker执行环境 #

方案A：修复Docker-in-Docker（DinD）配置 #

如果使用DinD服务，确保版本匹配并配置正确的TLS参数：

build-native-image:
  image: maven:3.9.6-graalvm-ce-21
  services:
    # 使用与客户端版本兼容的DinD镜像
    - docker:24.0.7-dind
  variables:
    DOCKER_HOST: tcp://docker:2376
    DOCKER_TLS_CERTDIR: "/certs"
    DOCKER_TLS_VERIFY: 1
    DOCKER_CERT_PATH: "$DOCKER_TLS_CERTDIR/client"
  script:
    - docker version
    - mvn -U -Pnative spring-boot:build-image -DskipTests -Dspring-boot.build-image.docker-api-version=1.41
  tags:
    - docker

方案B：改用宿主机Docker Socket挂载（推荐） #

跳过DinD，直接挂载宿主机的Docker socket，避免版本和TLS问题：

build-native-image:
  image: maven:3.9.6-graalvm-ce-21
  variables:
    DOCKER_HOST: unix:///var/run/docker.sock
  script:
    - docker version
    - mvn -U -Pnative spring-boot:build-image -DskipTests
  tags:
    - docker
  before_script:
    # 确保socket权限可访问
    - chmod 666 /var/run/docker.sock

4. 禁用不必要的Docker TLS验证 #

如果GitLab Runner的Docker服务未启用TLS，客户端默认的TLS验证会导致请求错误：

• 命令行添加参数：

  mvn -U -Pnative spring-boot:build-image -DskipTests -Dspring-boot.build-image.docker-tls-verify=false
  

• 或在pom.xml中配置：

  <plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
      <dockerTlsVerify>false</dockerTlsVerify>
      <!-- 其他配置 -->
    </configuration>
  </plugin>
  

5. 验证镜像拉取的网络与权限 #

• 在CI作业中手动执行docker pull docker.io/paketobuildpacks/builder-jammy-tiny:latest，确认是否能正常拉取镜像。
• 如果拉取失败，检查GitLab Runner的网络是否能访问Docker Hub，必要时配置Docker镜像加速器。

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