alibaba/nacos · error · PluginPersistenceException

Failed to save plugin config: {pluginId}

Error message

Failed to save plugin config: {pluginId}

What it means

Error "Failed to save plugin config: {pluginId}" thrown in alibaba/nacos.

Source

Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/storage/FilePluginStatePersistenceImpl.java:140

    }
    
    /**
     * Save plugin configuration.
     *
     * @param pluginId plugin ID
     * @param config configuration key-value pairs
     */
    @Override
    public void saveConfig(String pluginId, Map<String, String> config) {
        synchronized (configLock) {
            try {
                Map<String, Map<String, String>> configs = loadAllConfigs();
                configs.put(pluginId, config);
                writeJsonToFile(PLUGIN_CONFIG_FILE, configs);
                LOGGER.debug("[FilePluginStatePersistenceImpl] Saved plugin config for {}",
                    pluginId);
            } catch (Exception e) {
                throw new PluginPersistenceException("Failed to save plugin config: " + pluginId,
                    e);
            }
        }
    }
    
    @Override
    public void replaceAllConfigs(Map<String, Map<String, String>> configs) {
        synchronized (configLock) {
            try {
                Map<String, Map<String, String>> configsToStore = configs == null
                    ? new HashMap<>() : new HashMap<>(configs);
                writeJsonToFile(PLUGIN_CONFIG_FILE, configsToStore);
                LOGGER.debug("[FilePluginStatePersistenceImpl] Replaced all plugin configs");
            } catch (Exception e) {
                throw new PluginPersistenceException("Failed to replace all plugin configs", e);
            }
        }
    }

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Inspect the server logs for the underlying cause, fix it, and retry the operation.

When it happens

Trigger: Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/storage/FilePluginStatePersistenceImpl.java:140 when the library encounters an invalid state.

Common situations: Persisting a plugin config to disk failed.

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