halo-dev/halo · error · PluginDependencyException.NotFoundException

https://halo.run/probs/plugin-dependencies-not-found

https://halo.run/probs/plugin-dependencies-not-found

Error message

Dependencies were not found.

What it means

Error "Dependencies were not found." thrown in halo-dev/halo.

Source

Thrown at application/src/main/java/run/halo/app/plugin/PluginServiceImpl.java:187

    }

    private void checkDependencies(Plugin plugin) {
        var resolvedPlugins = new ArrayList<>(pluginManager.getResolvedPlugins());
        var pluginDescriptors = new ArrayList<PluginDescriptor>(resolvedPlugins.size() + 1);

        resolvedPlugins.stream().map(PluginWrapper::getDescriptor).forEach(pluginDescriptors::add);

        var pluginDescriptor = YamlPluginDescriptorFinder.convert(plugin);
        pluginDescriptors.add(pluginDescriptor);

        var deptResolver = new DependencyResolver(pluginManager.getVersionManager());
        var result = deptResolver.resolve(pluginDescriptors);
        if (result.hasCyclicDependency()) {
            throw new PluginDependencyException.CyclicException();
        }
        var notFoundDependencies = result.getNotFoundDependencies();
        if (!CollectionUtils.isEmpty(notFoundDependencies)) {
            throw new PluginDependencyException.NotFoundException(notFoundDependencies);
        }

        var wrongVersionDependencies = result.getWrongVersionDependencies();
        if (!CollectionUtils.isEmpty(wrongVersionDependencies)) {
            throw new PluginDependencyException.WrongVersionsException(wrongVersionDependencies);
        }
    }

    @Override
    public Mono<Plugin> upgrade(String name, Path path) {
        return findPluginManifest(path)
                .doOnNext(plugin -> {
                    satisfiesRequiresVersion(plugin);
                    checkDependencies(plugin);
                })
                .flatMap(pluginInPath -> {
                    // pre-check the plugin in the path
                    Assert.notNull(

View on GitHub (pinned to d2f5165f9c)

Solutions

1. Install or enable the missing dependent plugins listed in the error before enabling this plugin.
2. Check the plugin.yaml 'dependsOn' entries of the failing plugin and confirm each dependency name matches an installed plugin exactly.
3. If a dependency was uninstalled or renamed, either restore it or update the plugin's declared dependencies.

When it happens

Trigger: Thrown at application/src/main/java/run/halo/app/plugin/PluginServiceImpl.java:187 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of halo-dev/halo@d2f5165f9c (2026-08-14). Data as JSON: /api/errors/bb166719b34a36a6. Report an issue: GitHub.