alibaba/nacos · error · PluginPersistenceException
Failed to replace all plugin states
Error message
Failed to replace all plugin states
What it means
Error "Failed to replace all plugin states" thrown in alibaba/nacos.
Source
Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/storage/FilePluginStatePersistenceImpl.java:119
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);
}
}
}
/**
* 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 {}",View on GitHub (pinned to 9b989acdf1)
Solutions
- 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:119 when the library encounters an invalid state.
Common situations: Replacing all plugin states on disk failed.
AI-assisted analysis of alibaba/nacos@9b989acdf1 (2026-08-14).
Data as JSON: /api/errors/8164f1f54036ec80.
Report an issue: GitHub.