%s does not contain the expected libjavavm interface: missin

Error message

%s does not contain the expected libjavavm interface: missing

What it means

Error "%s does not contain the expected libjavavm interface: missing " thrown in oracle/graal.

Source

Thrown at espresso/src/com.oracle.truffle.espresso.mokapot/src/mokapot.c:1885

        return NULL;
    }
    char espresso_path[MAX_PATH];
    strncpy(espresso_path, mokapot_path, prefix_len);
    strncpy(espresso_path + prefix_len, lib_path, MAX_PATH - prefix_len);
    espresso_path[prefix_len + lib_name_len] = '\0';

    OS_DL_HANDLE libjavavm = os_dl_open(espresso_path);
    if (libjavavm == NULL) {
        fprintf(stderr, "Failed to open %s: %s" OS_NEWLINE_STR, espresso_path, os_dl_error());
        return NULL;
    }

#define BIND_LIBJAVAVM_SVM_API(X) \
    graal_ ## X ## _fn_t graal_ ## X = os_dl_sym(libjavavm, "graal_" #X); \
    if (graal_ ## X == NULL) { \
        graal_ ## X = os_dl_sym(libjavavm, "truffle_isolate_" #X); \
        if (graal_ ## X == NULL) { \
            fprintf(stderr, "%s does not contain the expected libjavavm interface: missing " #X OS_NEWLINE_STR, espresso_path); \
            return NULL; \
        } \
    }

#define BIND_LIBJAVAVM(X) \
    X ## _fn_t X = os_dl_sym(libjavavm, #X); \
    if (X == NULL) { \
        fprintf(stderr, "%s does not contain the expected libjavavm interface: missing " #X OS_NEWLINE_STR, espresso_path); \
        return NULL; \
    }

    BIND_LIBJAVAVM_SVM_API(create_isolate)
    BIND_LIBJAVAVM_SVM_API(attach_thread)
    BIND_LIBJAVAVM_SVM_API(detach_thread)
    BIND_LIBJAVAVM_SVM_API(get_current_thread)
    BIND_LIBJAVAVM_SVM_API(tear_down_isolate)
    BIND_LIBJAVAVM_SVM_API(detach_all_threads_and_tear_down_isolate)
    BIND_LIBJAVAVM(Espresso_CreateJavaVM)

View on GitHub (pinned to a66e9ccd1d)

Solutions

Fix the condition reported by the error: {} does not contain the expected libjavavm interface: missing
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: {} does not contain the expected libjavavm interface: missing

When it happens

Trigger: Thrown at espresso/src/com.oracle.truffle.espresso.mokapot/src/mokapot.c:1885 when the library encounters an invalid state.

Common situations: Occurs when a caller violates the contract guarded by this check: {} does not contain the expected libjavavm interface: missing

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