alibaba/nacos · error · PluginPersistenceException

Failed to save plugin state: {pluginId}

Error message

Failed to save plugin state: {pluginId}

What it means

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

Source

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

    }
    
    /**
     * Save plugin state.
     *
     * @param pluginId plugin ID
     * @param enabled whether the plugin is enabled
     */
    @Override
    public void saveState(String pluginId, boolean enabled) {
        synchronized (stateLock) {
            try {
                Map<String, Boolean> states = loadAllStates();
                states.put(pluginId, enabled);
                writeJsonToFile(PLUGIN_STATE_FILE, states);
                LOGGER.debug("[FilePluginStatePersistenceImpl] Saved plugin state: {}={}", pluginId,
                    enabled);
            } catch (Exception e) {
                throw new PluginPersistenceException("Failed to save plugin state: " + pluginId, e);
            }
        }
    }
    
    @Override
    public void replaceAllStates(Map<String, Boolean> states) {
        synchronized (stateLock) {
            try {
                Map<String, Boolean> statesToStore = states == null
                    ? new HashMap<>() : new HashMap<>(states);
                writeJsonToFile(PLUGIN_STATE_FILE, statesToStore);
                LOGGER.debug("[FilePluginStatePersistenceImpl] Replaced all plugin states");
            } catch (Exception e) {
                throw new PluginPersistenceException("Failed to replace all plugin states", 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:105 when the library encounters an invalid state.

Common situations: Persisting a plugin state to disk failed.

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