alibaba/nacos · error · IllegalArgumentException

Pre-context plugin configuration requires restart: {pluginId

Error message

Pre-context plugin configuration requires restart: {pluginId}

What it means

Error "Pre-context plugin configuration requires restart: {pluginId}" thrown in alibaba/nacos.

Source

Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/PluginManager.java:942

                    sourceDescription, pluginId);
            } else {
                result.put(pluginId, value);
            }
        });
        return result;
    }
    
    /**
     * Apply config change.
     * Called by synchronizers after successful synchronization.
     *
     * @param pluginId plugin ID
     * @param config configuration
     */
    @Override
    public void applyConfigChange(String pluginId, Map<String, String> config) {
        if (isPreContextPluginId(pluginId)) {
            throw new IllegalArgumentException(
                "Pre-context plugin configuration requires restart: " + pluginId);
        }
        PluginInfo info = pluginRegistry.get(pluginId);
        pluginConfigService.applyRuntimePersistedConfig(pluginId, info,
            pluginInstances.get(pluginId), config);
    }
    
    /**
     * Get all runtime persisted configs for a consensus snapshot.
     *
     * @return complete runtime persisted config snapshot
     */
    public Map<String, Map<String, String>> getRuntimePersistedConfigs() {
        return filterStandardEntries(pluginConfigService.getAllRuntimePersistedConfigs(),
            "runtime persisted plugin config");
    }
    
    /**

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Apply the change through the restart-aware configuration path and restart the server.

When it happens

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

Common situations: Changing configuration of a pre-context plugin that requires a restart.

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