如何判断Java程序是否运行在GraalVM AOT（SubstrateVM）环境中？

我之前做GraalVM Native Image相关开发的时候刚好研究过这个问题，分享几个实用且靠谱的判断方式，都是经过实际验证的：

1. 检查官方系统属性（最推荐） #

GraalVM Native Image在运行时会设置一个专属的系统属性org.graalvm.nativeimage.imagecode，当程序在native二进制环境运行时，这个属性的值为runtime；而在普通JVM环境下，这个属性不存在或者为空。

实现代码非常简洁：

public static boolean isRunningInNativeImage() {
    return System.getProperty("org.graalvm.nativeimage.imagecode") != null;
}

这是官方明确推荐的方式，兼容性最好，几乎不会因为GraalVM版本更新而失效。

2. 通过ImageInfo类判断（支持更细致场景） #

如果你需要区分native镜像构建阶段和native运行阶段，可以使用GraalVM提供的org.graalvm.nativeimage.ImageInfo类。这个类仅在Native Image环境中存在，普通JVM里找不到它。

为了避免编译时依赖问题，建议用反射来实现：

import java.lang.reflect.Method;

public static boolean isRunningInNativeImage() {
    try {
        Class<?> imageInfoClass = Class.forName("org.graalvm.nativeimage.ImageInfo");
        Method isRuntimeMethod = imageInfoClass.getMethod("isRuntime");
        return (Boolean) isRuntimeMethod.invoke(null);
    } catch (Exception e) {
        // 捕获所有反射相关异常，说明不在Native Image环境
        return false;
    }
}

ImageInfo.isRuntime()会返回true当且仅当程序正运行在Native Image的运行时环境中，构建阶段调用这个方法会返回false，适合有更精细需求的场景。

3. 兜底方案：检查虚拟机名称 #

如果上面两种方式都不适用（比如非常老的GraalVM版本），可以通过java.vm.name系统属性判断，Native Image环境下这个属性的值会包含Substrate VM：

public static boolean isRunningInNativeImage() {
    String vmName = System.getProperty("java.vm.name");
    return vmName != null && vmName.contains("Substrate VM");
}

不过这个方式的可靠性稍差，因为虚拟机名称可能会随版本更新发生变化，所以只建议作为兜底选项。

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