{"record":{"id":"8e4a65c1d33ce21a","repo":"alibaba/nacos","slug":"pre-context-plugin-configuration-requires-restart","errorCode":null,"errorMessage":"Pre-context plugin configuration requires restart: {pluginId}","messagePattern":"Pre-context plugin configuration requires restart: (.+?)","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"core/src/main/java/com/alibaba/nacos/core/plugin/PluginManager.java","lineNumber":942,"sourceCode":"                    sourceDescription, pluginId);\n            } else {\n                result.put(pluginId, value);\n            }\n        });\n        return result;\n    }\n    \n    /**\n     * Apply config change.\n     * Called by synchronizers after successful synchronization.\n     *\n     * @param pluginId plugin ID\n     * @param config configuration\n     */\n    @Override\n    public void applyConfigChange(String pluginId, Map<String, String> config) {\n        if (isPreContextPluginId(pluginId)) {\n            throw new IllegalArgumentException(\n                \"Pre-context plugin configuration requires restart: \" + pluginId);\n        }\n        PluginInfo info = pluginRegistry.get(pluginId);\n        pluginConfigService.applyRuntimePersistedConfig(pluginId, info,\n            pluginInstances.get(pluginId), config);\n    }\n    \n    /**\n     * Get all runtime persisted configs for a consensus snapshot.\n     *\n     * @return complete runtime persisted config snapshot\n     */\n    public Map<String, Map<String, String>> getRuntimePersistedConfigs() {\n        return filterStandardEntries(pluginConfigService.getAllRuntimePersistedConfigs(),\n            \"runtime persisted plugin config\");\n    }\n    \n    /**","sourceCodeStart":924,"sourceCodeEnd":960,"githubUrl":"https://github.com/alibaba/nacos/blob/9b989acdf181d00898f2e8839257bb2b2a3cefe3/core/src/main/java/com/alibaba/nacos/core/plugin/PluginManager.java#L924-L960","documentation":"Error \"Pre-context plugin configuration requires restart: {pluginId}\" thrown in alibaba/nacos.","triggerScenarios":"Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/PluginManager.java:942 when the library encounters an invalid state.","commonSituations":"Changing configuration of a pre-context plugin that requires a restart.","solutions":["Apply the change through the restart-aware configuration path and restart the server."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"9b989acdf181d00898f2e8839257bb2b2a3cefe3","analyzedAt":"2026-08-14T07:17:31.569Z","schemaVersion":2},"datasetVersion":"2026-08-14T10:17:34.591Z"}