oracle/graal · error · InternalError

Failed to load org.graalvm.jniutils.JNIExceptionWrapperEntry

Error message

Failed to load org.graalvm.jniutils.JNIExceptionWrapperEntryPoints

What it means

Error "Failed to load org.graalvm.jniutils.JNIExceptionWrapperEntryPoints" thrown in oracle/graal.

Source

Thrown at sdk/src/org.graalvm.jniutils/src/org/graalvm/jniutils/JNIExceptionWrapper.java:617

    private static JNI.JClass getEntryPoints(JNIEnv env) {
        JNI.JClass res = entryPointsClass;
        if (res.isNull()) {
            String binaryName = getBinaryName(HS_ENTRYPOINTS_CLASS);
            JNI.JClass entryPoints = findClass(env, binaryName);
            if (entryPoints.isNull()) {
                // Clear the exception and try to load the entry points class using JVMCI
                // classloader.
                ExceptionClear(env);
                JObject classLoader = getJVMCIClassLoader(env);
                if (classLoader.isNonNull()) {
                    entryPoints = findClass(env, classLoader, binaryName);
                }
            }
            if (entryPoints.isNull()) {
                // Here we cannot use JNIExceptionWrapper.
                // We failed to load HostSpot entry points for it.
                ExceptionClear(env);
                throw new InternalError("Failed to load " + HS_ENTRYPOINTS_CLASS);
            }
            synchronized (JNIExceptionWrapper.class) {
                res = entryPointsClass;
                if (res.isNull()) {
                    res = NewGlobalRef(env, entryPoints, "Class<" + HS_ENTRYPOINTS_CLASS + ">");
                    entryPointsClass = res;
                }
            }
        }
        return res;
    }

    /**
     * Determines if {@code frame} is for a method denoting a JNI API call using
     * {@code CFunctionPointer}.
     */
    private static boolean isJNIAPICall(StackTraceElement frame) {
        return frame.getClassName().startsWith(JNI_FUNCTION_POINTER_CLASS_PREFIX);

View on GitHub (pinned to a66e9ccd1d)

Solutions

1. Fix the condition reported by the error: Failed to load org.graalvm.jniutils.JNIExceptionWrapperEntryPoints
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: Failed to load org.graalvm.jniutils.JNIExceptionWrapperEntryPoints

When it happens

Trigger: Thrown at sdk/src/org.graalvm.jniutils/src/org/graalvm/jniutils/JNIExceptionWrapper.java:617 when the library encounters an invalid state.

Common situations: Occurs when a caller violates the contract guarded by this check: Failed to load org.graalvm.jniutils.JNIExceptionWrapperEntryPoints

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