alibaba/nacos · error · PluginPersistenceException

Runtime persisted plugin config storage '{storageName}' is u

Error message

Runtime persisted plugin config storage '{storageName}' is unavailable

What it means

Error "Runtime persisted plugin config storage '{storageName}' is unavailable" thrown in alibaba/nacos.

Source

Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/config/RuntimePersistedPluginConfigSourceResolver.java:156

    @Override
    public PluginConfigSourceType getSourceType() {
        return PluginConfigSourceType.RUNTIME_PERSISTED;
    }
    
    private Map<String, Map<String, String>> copyConfigs(
        Map<String, Map<String, String>> configs) {
        Map<String, Map<String, String>> result = new HashMap<>();
        if (configs != null) {
            configs.forEach((pluginId, config) -> result.put(pluginId,
                config == null ? Collections.emptyMap() : new HashMap<>(config)));
        }
        return result;
    }
    
    private PluginConfigStorage getAvailableStorage() {
        initialize();
        if (!available || storage == null) {
            throw new PluginPersistenceException("Runtime persisted plugin config storage '"
                + getStorageName() + "' is unavailable", unavailableCause);
        }
        return storage;
    }
    
    private void markUnavailable(Throwable cause) {
        available = false;
        unavailableCause = cause;
        replaceAllConfigs(Collections.emptyMap());
        shutdownStorage();
        if (cause == null) {
            LOGGER.error("[RuntimePersistedPluginConfigSourceResolver] No plugin config storage "
                + "is enabled. Continue startup without runtime persisted config.");
        } else {
            LOGGER.error("[RuntimePersistedPluginConfigSourceResolver] Failed to initialize or "
                + "read storage '{}'. Continue startup without runtime persisted config.",
                getStorageName(), cause);
        }

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Check the server/plugin configuration and enable the required module or use a supported alternative.

When it happens

Trigger: Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/config/RuntimePersistedPluginConfigSourceResolver.java:156 when the library encounters an invalid state.

Common situations: The named runtime persisted plugin config storage is unavailable.

AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14). Data as JSON: /api/errors/c5911ab4a13c453e. Report an issue: GitHub.