Gradle bootBuildImage任务遇Docker API 400错误及GitHub访问问题求助

一、先查配置层面的常见坑 #

• Bindings格式不符合规范：Paketo的dependency-mapping绑定有严格的目录要求，别瞎写结构。比如要建一个绑定目录，里面的子目录（比如命名为jre-binding）必须包含：
  • type文件，内容固定为dependency-mapping
  • metadata子目录，里面放artifact-uri（本地JRE包的绝对路径，格式为file:///xxx/jre-21.0.1.tar.gz）和version文件（内容为21.0.1）
    路径写错、类型不匹配都会导致容器创建参数出错，返回400。
• Gradle参数配置错误：检查build.gradle里的bootBuildImage块，必须指定本地仓库的builder和run镜像，示例配置：

  bootBuildImage {
      builder = 'localhost:5000/paketobuildpacks/builder-jammy-full'
      runImage = 'localhost:5000/paketobuildpacks/run-jammy-full'
      environment = [
          'BP_JVM_VERSION': '21'
      ]
      bindings = ['/绝对路径/到/你的绑定目录']
  }
  

  别写错镜像地址，bindings优先用绝对路径，避免相对路径踩坑。
• JRE包格式不兼容：Paketo只认标准tar.gz格式的JRE包，解压后必须有bin/java这类标准结构。你下载的包要是改名、格式损坏或者结构异常，buildpack处理时会生成错误的容器参数，直接触发400。手动解压检查结构是否正常。

二、再排查本地Docker仓库的问题 #

• 镜像拉取是否正常：手动执行docker pull localhost:5000/paketobuildpacks/builder-jammy-full和docker pull localhost:5000/paketobuildpacks/run-jammy-full，拉取失败说明仓库有问题——要么推送时镜像没传全，要么标签写错，或者仓库需要认证但Gradle未配置。
• 镜像完整性检查：用docker inspect localhost:5000/paketobuildpacks/builder-jammy-full查看元数据，对比官方镜像的层数、环境变量等信息，要是缺层或元数据混乱，说明推送过程出错，重新推送一次试试。
• Docker API版本/权限问题：执行docker version查看Server端的API版本，要是低于1.24，Gradle用v1.24调用必然报错。另外，确认执行Gradle命令的用户是否有Docker操作权限（比如是否在docker用户组），权限不足也可能引发400错误。

三、终极定位：查看详细日志 #

添加--info参数执行Gradle命令：./gradlew bootBuildImage --info，找到Docker API调用的具体请求参数和错误响应内容。400错误通常会返回明确原因（比如"参数格式错误"、"路径不存在"），能直接定位问题。
如果还不确定，手动用curl测试Docker API：

curl -X POST -H "Content-Type: application/json" http://localhost/v1.24/containers/create -d '{
    "Image": "localhost:5000/paketobuildpacks/run-jammy-full",
    "Cmd": ["echo", "test"]
}'

这个调用也返回400，就是Docker daemon或本地仓库的问题；调用成功的话，肯定是Gradle配置哪里写错了。

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