Spring Boot 2.7.1 Native：Gradle bootBuildImage依赖映射绑定配置报错

问题诊断 #

你当前配置存在两个关键问题：

• 绑定路径拼写错误：bindnings应为bindings
• Docker API 400错误通常因挂载路径不存在或权限不足导致容器无法访问绑定目录

正确配置步骤 #

1. 构建本地绑定目录结构 #

在项目根目录下创建如下目录和文件：

bindings/
└── bellsoft-jre-config/
    ├── type                # 文件内容固定为：dependency-mapping
    └── <SHA256哈希值>       # 文件名是官方依赖的SHA256值，文件内容为可访问的依赖URL（如公司内部镜像源地址）

• SHA256值获取：从之前构建失败的日志中提取被拦截的依赖URL，URL末尾会附带该哈希值（格式类似https://.../liberica-...tar.gz#<SHA256>）
• 若使用本地已下载的依赖包，URL格式为file:///绝对路径/to/liberica-native-imagekit.tar.gz

2. 修正bootBuildImage配置 #

以下提供两种正确的绑定写法，推荐Map形式更易读且支持动态路径：

写法一：字符串形式

bootBuildImage {
    builder = 'docker.io/paketobuildpacks/builder:tiny'
    runImage = 'docker.io/paketobuildpacks/run:tiny-cnb'
    buildpacks = ['gcr.io/paketo-buildpacks/java-native-image:7.19.0'] // 指定固定版本避免兼容性问题
    binding('bindings/bellsoft-jre-config:/platform/bindings/bellsoft-jre-config')
    environment = [
        "BP_NATIVE_IMAGE": "true"
    ]
}

写法二：Map形式（推荐）

bootBuildImage {
    builder = 'docker.io/paketobuildpacks/builder:tiny'
    runImage = 'docker.io/paketobuildpacks/run:tiny-cnb'
    buildpacks = ['gcr.io/paketo-buildpacks/java-native-image:7.19.0']
    bindings {
        binding(source: file('bindings/bellsoft-jre-config'), destination: '/platform/bindings/bellsoft-jre-config')
    }
    environment = [
        "BP_NATIVE_IMAGE": "true"
    ]
}

3. 权限验证 #

• 确保bindings目录及其子文件对当前用户和Docker进程有可读权限（Linux/macOS下可执行chmod -R 755 bindings）
• 运行构建命令：./gradlew bootBuildImage，查看日志中是否出现Using dependency-mapping binding for ...的提示，确认buildpack已使用绑定的依赖

额外注意事项 #

• 使用本地文件路径时必须用绝对路径的file://格式，相对路径无法被容器识别
• 绑定的SHA256值必须与buildpack期望的完全一致，否则会触发重新下载

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