使用Gradle构建Quarkus原生镜像时如何正确增大最大堆内存

首先得明确：quarkus.native.native-image-xmx这个参数是用来配置GraalVM原生镜像生成工具的堆内存，而非Gradle自身JVM的内存。你之前添加的参数没生效，大概率是因为参数传递方式不对，或者Quarkus插件没有正确拾取到这个配置。

下面给你几个可靠的解决方案，按推荐程度排序：

1. 在gradle.properties中配置（最简洁） #

在项目根目录的gradle.properties文件中添加一行：

quarkus.native.native-image-xmx=8g

这样每次执行Gradle构建时，Quarkus插件会自动读取这个配置，并传递给GraalVM的native-image工具。

2. 在build.gradle中直接配置Native Image参数（最灵活） #

如果需要更精细的控制，可以在build.gradle里直接给native-image命令添加JVM参数：

quarkus {
    native {
        nativeImage {
            // 直接传递-Xmx参数给GraalVM的JVM
            arguments.add("-J-Xmx8g")
            // 可选：添加其他native-image参数，比如开启调试
            // arguments.add("-g")
        }
    }
}

这种方式绕过了Quarkus的属性映射，直接给native-image命令传递-J-Xmx8g（-J前缀是GraalVM用来识别JVM参数的标识），确保参数一定会生效。

3. 调整Gradle命令的参数传递方式 #

如果你还是想用命令行参数，需要确保Gradle把系统属性传递给Quarkus的构建任务。可以尝试用-P传递项目属性，再在build.gradle中映射：
首先执行命令：

./gradlew build -Dquarkus.package.type=native -Dquarkus.native.container-build=true -PnativeXmx=8g

然后在build.gradle中添加：

quarkus {
    native {
        nativeImage {
            if (project.hasProperty('nativeXmx')) {
                arguments.add("-J-Xmx${project.property('nativeXmx')}")
            }
        }
    }
}

验证参数是否生效 #

你可以添加-Dquarkus.native.debug=true参数执行构建，这样Quarkus会打印出完整的native-image执行命令。比如你会看到类似这样的输出：

[INFO] [io.quarkus.deployment.pkg.steps.NativeImageBuildStep] Running: /path/to/graalvm/bin/native-image -J-Xmx8g ...

如果命令里包含-J-Xmx8g，就说明参数已经正确生效了。

另外要注意：如果是用容器构建（quarkus.native.container-build=true），你需要确保容器有足够的内存配额。比如用Docker的话，需要调整Docker Desktop的内存限制（默认可能只有2GB），否则即使配置了-Xmx8g，容器内存不够也会导致OOM退出（代码137）。

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