alibaba/nacos · error · PluginPersistenceException

Failed to create plugin data directory: {dataDir}

Error message

Failed to create plugin data directory: {dataDir}

What it means

Error "Failed to create plugin data directory: {dataDir}" thrown in alibaba/nacos.

Source

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

    
    private final Object configLock = new Object();
    
    public FilePluginStatePersistenceImpl() {
        this.dataDir =
            EnvUtil.getNacosHome() + File.separator + "data" + File.separator + PLUGIN_DATA_DIR;
    }
    
    private void ensureDataDirExists() {
        Path directory = Paths.get(dataDir);
        if (Files.isDirectory(directory)) {
            return;
        }
        try {
            Files.createDirectories(directory);
            LOGGER.info("[FilePluginStatePersistenceImpl] Created plugin data directory: {}",
                dataDir);
        } catch (IOException e) {
            throw new PluginPersistenceException(
                "Failed to create plugin data directory: " + dataDir, e);
        }
    }
    
    /**
     * 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,

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:84 when the library encounters an invalid state.

Common situations: Creating the plugin data directory on disk failed.

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