如何用Spring Boot 3.x的bootBuildImage任务构建指定架构镜像？

使用M1 Pro设备构建Spring Boot镜像时，默认生成linux/arm64架构镜像，无法适配云K8s的linux/amd64部署需求。CI在Linux机器上构建正常，但本地调试每次依赖CI效率极低。当前Gradle的bootBuildImage任务配置如下：

plugins {
    kotlin("jvm") version "1.9.24"
    kotlin("plugin.spring") version "1.9.24"
    id("org.springframework.boot") version "3.3.2"
    id("io.spring.dependency-management") version "1.1.6"
    kotlin("plugin.jpa") version "1.9.24"
    id("org.springframework.boot.aot") version "3.3.2"
}

....

tasks.named<BootBuildImage>("bootBuildImage") {
    val imageNameValue = System.getenv("BACKEND_IMAGE_NAME")
    imageName.set(imageNameValue)

    // Enable CDS and Spring AOT
    environment.put("BP_JVM_CDS_ENABLED", "true")
    environment.put("BP_SPRING_AOT_ENABLED", "true")

    environment.put("SPRING_PROFILES_ACTIVE", "bootBuildProfile")

    // For multi arch (Apple Silicon) support
    builder.set("paketobuildpacks/builder-jammy-buildpackless-tiny")
    buildpacks.set(listOf("paketobuildpacks/java"))
}

如何配置才能强制构建linux/amd64架构的镜像？

要在M1 Pro上强制构建linux/amd64镜像，需完成以下两步配置：

1. 修改Gradle bootBuildImage任务配置 #

在任务中添加目标平台指定参数，明确告知Buildpack插件要构建的架构：

tasks.named<BootBuildImage>("bootBuildImage") {
    val imageNameValue = System.getenv("BACKEND_IMAGE_NAME")
    imageName.set(imageNameValue)

    // Enable CDS and Spring AOT
    environment.put("BP_JVM_CDS_ENABLED", "true")
    environment.put("BP_SPRING_AOT_ENABLED", "true")

    environment.put("SPRING_PROFILES_ACTIVE", "bootBuildProfile")

    // 强制指定目标架构为linux/amd64
    platforms.set(listOf("linux/amd64"))
    // 通知Java Buildpack编译适配amd64的二进制文件
    environment.put("BP_TARGET_PLATFORM", "linux/amd64")

    builder.set("paketobuildpacks/builder-jammy-buildpackless-tiny")
    buildpacks.set(listOf("paketobuildpacks/java"))
}

2. 开启Docker跨架构构建支持 #

M1 Pro为arm64架构，需确保Docker能模拟x86环境：

• 打开Docker Desktop，进入设置 -> Features in Development，勾选Enable Rosetta for x86/amd64 emulation on Apple Silicon
• 若使用Docker Buildx，执行以下命令创建多架构构建器：

docker buildx create --name multiarch --use
docker buildx inspect --bootstrap

关键说明 #

• platforms属性：让Spring Boot Buildpack插件直接生成指定架构的镜像
• BP_TARGET_PLATFORM：确保Java Buildpack编译出的应用二进制适配linux/amd64，避免运行时架构不兼容
• 开启Rosetta模拟能显著提升x86架构镜像的构建速度，减少本地调试的等待时间

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