apache/maven · error · IllegalStateException

Required test instance is not available in ExtensionContext

Error message

Required test instance is not available in ExtensionContext

What it means

Error "Required test instance is not available in ExtensionContext" thrown in apache/maven.

Source

Thrown at impl/maven-testing/src/main/java/org/apache/maven/testing/di/MavenDIExtension.java:111

    /**
     * Creates and configures the DI container for test execution.
     * Performs component discovery and sets up basic bindings.
     *
     * @throws IllegalStateException if the ExtensionContext is null, the required test class is unavailable,
     *         the required test instance is unavailable, or if container setup fails
     */
    protected Injector setupContainer(ExtensionContext context) {
        if (context == null) {
            throw new IllegalStateException("ExtensionContext must not be null");
        }
        final Class<?> testClass = context.getRequiredTestClass();
        if (testClass == null) {
            throw new IllegalStateException("Required test class is not available in ExtensionContext");
        }
        final Object testInstance = context.getRequiredTestInstance();
        if (testInstance == null) {
            throw new IllegalStateException("Required test instance is not available in ExtensionContext");
        }

        try {
            Injector injector = Injector.create();
            injector.bindInstance(ExtensionContext.class, context);
            injector.discover(testClass.getClassLoader());
            injector.bindInstance(Injector.class, injector);
            injector.bindInstance(testClass.asSubclass(Object.class), (Object) testInstance); // Safe generics handling
            return injector;
        } catch (final Exception e) {
            throw new IllegalStateException(
                    String.format(
                            "Failed to set up DI injector for test class '%s': %s",
                            testClass.getName(), e.getMessage()),
                    e);
        }
    }

View on GitHub (pinned to e4093d4e12)

When it happens

Trigger: Thrown at impl/maven-testing/src/main/java/org/apache/maven/testing/di/MavenDIExtension.java:111 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/maven@e4093d4e12 (2026-08-21). Data as JSON: /api/errors/67c837bf15f718ee. Report an issue: GitHub.