kestra-io/kestra · error · IllegalArgumentException

Unable to find base class from '{}'

Error message

Unable to find base class from '{}'

What it means

Error "Unable to find base class from '{}'" thrown in kestra-io/kestra.

Source

Thrown at core/src/main/java/io/kestra/core/plugins/RegisteredPlugin.java:198

        if (this.getRules().stream().anyMatch(r -> r.getName().equals(cls))) {
            return RulePluginInterface.class;
        }

        if (this.getAdditionalPlugins().stream().anyMatch(r -> r.getName().equals(cls))) {
            return AdditionalPlugin.class;
        }

        if (this.getFileRenderers().stream().anyMatch(r -> r.getName().equals(cls))) {
            return FileRenderer.class;
        }

        if (this.getAliases().containsKey(cls.toLowerCase())) {
            // This is a quick-win, but it may trigger an infinite loop ... or not ...
            return baseClass(this.getAliases().get(cls.toLowerCase()).getValue().getName());
        }

        throw new IllegalArgumentException("Unable to find base class from '" + cls + "'");
    }

    @SuppressWarnings("rawtypes")
    public List<Class> allClass() {
        return allClassGrouped()
            .entrySet()
            .stream()
            .flatMap(map -> map.getValue().stream())
            .toList();
    }

    @SuppressWarnings("rawtypes")
    public Map<String, List<Class>> allClassGrouped() {
        Map<String, List<Class>> result = new HashMap<>();

        result.put(TASKS_GROUP_NAME, Arrays.asList(this.getTasks().toArray(Class[]::new)));
        result.put(TRIGGERS_GROUP_NAME, Arrays.asList(this.getTriggers().toArray(Class[]::new)));
        result.put(STORAGES_GROUP_NAME, Arrays.asList(this.getStorages().toArray(Class[]::new)));

View on GitHub (pinned to 823fada927)

Solutions

1. Check that the referenced class exists in the plugin JAR and is on the plugin's classpath.
2. Rebuild or reinstall the plugin so the expected base class is packaged and loadable.

When it happens

Trigger: Thrown at core/src/main/java/io/kestra/core/plugins/RegisteredPlugin.java:198 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of kestra-io/kestra@823fada927 (2026-08-14). Data as JSON: /api/errors/4b3481310c3f2956. Report an issue: GitHub.