GraalVM静态原生镜像无法在Dockerfile的ENTRYPOINT中传递JAVA_OPTS

方法1：在Java代码中读取环境变量解析参数 #

因为静态原生镜像没有shell，无法直接展开环境变量，最灵活的方式是在应用代码中主动读取JAVA_OPTS环境变量并解析：

public static void main(String[] args) {
    String javaOpts = System.getenv("JAVA_OPTS");
    if (javaOpts != null && !javaOpts.isBlank()) {
        for (String opt : javaOpts.split("\\s+")) {
            // 处理-D开头的系统属性
            if (opt.startsWith("-D")) {
                int eqPos = opt.indexOf('=');
                if (eqPos > 2) {
                    String propKey = opt.substring(2, eqPos);
                    String propValue = opt.substring(eqPos + 1);
                    System.setProperty(propKey, propValue);
                }
            }
            // 注意：部分-X开头的JVM参数需要在原生镜像构建时指定，运行时无法修改
        }
    }
    // 启动你的应用逻辑
}

然后在Dockerfile中设置默认环境变量，并使用exec形式的ENTRYPOINT：

ENV JAVA_OPTS="-Dapp.env=prod -Xmx512m"
ENTRYPOINT ["./your-native-app"]

运行容器时可以直接覆盖环境变量：

docker run -e JAVA_OPTS="-Dapp.env=dev -Xmx256m" your-image

方法2：添加静态shell到镜像中 #

如果不想修改代码，可以给静态镜像添加一个静态编译的shell（比如busybox），通过shell来展开JAVA_OPTS：

# 先从alpine获取静态busybox
FROM alpine:3.18 as builder
RUN apk add --no-cache busybox-static

# 基于scratch构建最终镜像
FROM scratch
# 复制静态shell
COPY --from=builder /bin/busybox /bin/sh
# 复制你的原生镜像
COPY your-native-app /
# 使用shell执行命令，展开环境变量
ENTRYPOINT ["/bin/sh", "-c", "./your-native-app $JAVA_OPTS"]

这种方式可以直接在JAVA_OPTS中传递所有原生镜像支持的参数，无需修改代码，但会增加镜像体积（busybox仅~1MB）。

方法3：构建时固化参数（适合固定场景） #

如果参数是固定的，不需要运行时修改，可以在构建原生镜像时直接通过-J前缀传递JVM参数，这些参数会被固化到镜像中：

native-image -J-Xmx1g -J-Dapp.config=prod -jar your-app.jar

构建完成的原生镜像运行时会自动使用这些参数，无需在Dockerfile中额外配置。

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