jruby/jruby · error · RuntimeException

unknown bundle: ${symbolicName}

Error message

unknown bundle: ${symbolicName}

What it means

Error "unknown bundle: ${symbolicName}" thrown in jruby/jruby.

Source

Thrown at core/src/main/java/org/jruby/embed/osgi/OSGiIsolatedScriptingContainer.java:64

    public OSGiIsolatedScriptingContainer( LocalContextScope scope,
                                           LocalVariableBehavior behavior,
                                           boolean lazy )
    {
        super(scope, behavior, lazy);
    }

    private Bundle toBundle(String symbolicName) {
        BundleContext context = FrameworkUtil.getBundle(getClass()).getBundleContext();
        Bundle bundle = null;
        for (Bundle b : context.getBundles()) {
            if (b.getSymbolicName().equals(symbolicName)) {
                bundle = b;
                break;
            }
        }
        if (bundle == null ) {
            throw new RuntimeException("unknown bundle: " + symbolicName);
        }
        return bundle;
    }

    /**
     * add the classloader from the given bundle to the LOAD_PATH and the GEM_PATH
     * using the bundle symbolic name
     * @param symbolicName
     */
    public void addBundle(String symbolicName) {
        addBundle(toBundle(symbolicName));
    }

    /**
     * add the classloader from the given bundle to the LOAD_PATH and the GEM_PATH
     * @param bundle
     */
    public void addBundle(Bundle bundle) {

View on GitHub (pinned to fb650c13e0)

Solutions

1. The OSGi bundle with the given symbolic name is not installed or not resolved in the framework. Install/start the bundle and verify the symbolic name matches Bundle-SymbolicName.

When it happens

Trigger: Thrown at core/src/main/java/org/jruby/embed/osgi/OSGiIsolatedScriptingContainer.java:64 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of jruby/jruby@fb650c13e0 (2026-08-23). Data as JSON: /api/errors/bdad0aca5b8be99a. Report an issue: GitHub.