oracle/graal · error · AssertionError

Missing jimage in java.home: <javaHome>

Error message

Missing jimage in java.home: <javaHome>

What it means

Error "Missing jimage in java.home: <javaHome>" thrown in oracle/graal.

Source

Thrown at sdk/src/org.graalvm.home/src/org/graalvm/home/impl/DefaultHomeFinder.java:194

                    return null;
                }
            }
            return home;
        } else {
            final String javaHomeProperty = System.getProperty("java.home");
            if (javaHomeProperty == null) {
                throw new AssertionError("The java.home system property is not set");
            }

            final Path javaHome = Paths.get(javaHomeProperty);
            if (!Files.exists(javaHome)) {
                throw new AssertionError("Java home is not reachable.");
            }

            if (Files.exists(javaHome.resolve(Paths.get("lib", "modules")))) {
                home = javaHome;
            } else {
                throw new AssertionError("Missing jimage in java.home: " + javaHome);
            }

            verbose("GraalVM home found by java.home property as: ", home);
            return home;
        }
    }

    @Override
    public String getVersion() {
        String res = version;
        if (res == null) {
            if (GRAALVM_VERSION != null) {
                res = GRAALVM_VERSION;
            } else {
                res = "snapshot";
                Path home = getHomeFolder();
                if (home != null) {
                    Path releaseFile = home.resolve("release");

View on GitHub (pinned to a66e9ccd1d)

Solutions

1. Fix the condition reported by the error: Missing jimage in java.home: <javaHome>
2. Check the throwing call site and ensure its documented preconditions (argument values, types, environment, or configuration) are satisfied before the call.

Example fix

Validate inputs and environment so that the failing condition does not occur: Missing jimage in java.home: <javaHome>

When it happens

Trigger: Thrown at sdk/src/org.graalvm.home/src/org/graalvm/home/impl/DefaultHomeFinder.java:194 when the library encounters an invalid state.

Common situations: Occurs when a caller violates the contract guarded by this check: Missing jimage in java.home: <javaHome>

AI-assisted analysis of oracle/graal@a66e9ccd1d (2026-08-14). Data as JSON: /api/errors/d8ed3f534b98c8d1. Report an issue: GitHub.