如何为Spring Boot分层Docker镜像配置运行时JVM参数并启用Java预览特性

核心问题说明 #

你当前执行mvn spring-boot:build-image用的是Spring Boot默认的Cloud Native Buildpacks构建镜像，不会读取你本地编写的Dockerfile，所以Dockerfile里的配置完全不生效；同时你写的Dockerfile本身也有逻辑问题：RUN --env定义的环境变量仅在当前RUN指令生效，不会持久到镜像运行阶段。

启用Java预览特性解决方案 #

场景1：继续使用spring-boot:build-image命令构建镜像 #

直接在Spring Boot Maven插件中添加镜像环境变量配置即可，修改后的插件配置如下：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <layers>
            <configuration>${project.basedir}/src/main/layers.xml</configuration>
        </layers>
        <!-- 新增镜像环境变量配置 -->
        <image>
            <env>
                <!-- 启用Java预览特性，其他固定JVM参数也可直接加在这里 -->
                <JAVA_TOOL_OPTIONS>--enable-preview</JAVA_TOOL_OPTIONS>
            </env>
        </image>
    </configuration>
</plugin>

修改后重新执行mvn spring-boot:build-image构建镜像即可。

场景2：使用本地编写的Dockerfile构建镜像 #

你需要先执行mvn package打好jar包，再执行docker build命令用本地Dockerfile构建，不要用spring-boot:build-image命令。
同时修改Dockerfile，把预览参数配置到运行阶段，修改后的Dockerfile如下：

FROM openjdk:16-jdk-slim AS builder
WORKDIR source
ARG JAR_FILE=target/whatever-name-of-the-application.jar
COPY ${JAR_FILE} application.jar
RUN java -Djarmode=layertools -jar application.jar extract

FROM openjdk:16-jdk-slim
WORKDIR application
COPY --from=builder source/dependencies/ ./
COPY --from=builder source/spring-boot-loader/ ./
COPY --from=builder source/snapshot-dependencies/ ./
COPY --from=builder source/application/ ./
# 新增环境变量配置，所有JVM参数都可以加在这里
ENV JAVA_TOOL_OPTIONS="--enable-preview"
ENTRYPOINT ["java", "org.springframework.boot.loader.JarLauncher"]

扩展问题：运行时JVM参数配置方法 #

如果你用Buildpacks构建（spring-boot:build-image） #

• 固定参数：和启用预览特性的方式一致，直接在pom插件的<image><env>中添加JAVA_TOOL_OPTIONS的值即可，参数会内置到镜像中
• 动态参数：启动容器时通过环境变量传入，无需重新构建镜像，命令示例：

  docker run -e JAVA_TOOL_OPTIONS="-Xmx2g -Xms1g --enable-preview" <镜像ID>
  

• 专用参数配置：Spring Boot默认使用的Paketo Buildpacks支持BPL_JVM_HEADROOM、BPL_JVM_THREAD_COUNT等专用环境变量，无需手动拼接内存参数，可直接配置对应变量自动生成JVM参数。

如果你用自定义Dockerfile构建 #

• 固定参数：在Dockerfile中通过ENV JAVA_TOOL_OPTIONS="参数列表"配置，内置到镜像中
• 动态参数：和上面一致，启动容器时用-e JAVA_TOOL_OPTIONS="参数列表"传入覆盖即可
• 完全固定的参数也可以直接写在ENTRYPOINT的java命令后面，示例：

  ENTRYPOINT ["java", "-Xmx2g", "--enable-preview", "org.springframework.boot.loader.JarLauncher"]
  

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