{"record":{"id":"f65de7eaac598080","repo":"alibaba/nacos","slug":"runtime-persisted-plugin-config-source-is-unavaila","errorCode":null,"errorMessage":"Runtime persisted plugin config source is unavailable","messagePattern":"Runtime persisted plugin config source is unavailable","errorType":"exception","errorClass":"PluginPersistenceException","httpStatus":null,"severity":"error","filePath":"core/src/main/java/com/alibaba/nacos/core/plugin/config/PluginConfigService.java","lineNumber":76,"sourceCode":"        this.resolver = resolver;\n        this.checker = checker;\n        this.applier = applier;\n    }\n    \n    /**\n     * Normalize and validate a runtime update before local apply or cluster synchronization.\n     *\n     * @param pluginInfo plugin info\n     * @param config input full override map\n     * @param sourceType target runtime source\n     * @return normalized full override map\n     */\n    public Map<String, String> prepareRuntimeUpdate(PluginInfo pluginInfo,\n        Map<String, String> config, PluginConfigSourceType sourceType) {\n        validateRuntimeSource(sourceType);\n        if (PluginConfigSourceType.RUNTIME_PERSISTED == sourceType\n            && !resolver.isRuntimePersistedSourceAvailable()) {\n            throw new PluginPersistenceException(\n                \"Runtime persisted plugin config source is unavailable\");\n        }\n        synchronized (getPluginLock(pluginInfo.getPluginId())) {\n            Map<String, String> normalizedConfig = normalizeConfig(pluginInfo, config);\n            Map<String, String> preparedConfig = preserveMaskedSensitiveValues(pluginInfo,\n                normalizedConfig, sourceType);\n            validateRuntimeUpdate(pluginInfo, preparedConfig, sourceType);\n            return preparedConfig;\n        }\n    }\n    \n    /**\n     * Load the complete runtime persisted source during startup.\n     */\n    public void initializeRuntimePersistedConfigs() {\n        resolver.initializeRuntimePersistedConfigs();\n    }\n    ","sourceCodeStart":58,"sourceCodeEnd":94,"githubUrl":"https://github.com/alibaba/nacos/blob/9b989acdf181d00898f2e8839257bb2b2a3cefe3/core/src/main/java/com/alibaba/nacos/core/plugin/config/PluginConfigService.java#L58-L94","documentation":"Error \"Runtime persisted plugin config source is unavailable\" thrown in alibaba/nacos.","triggerScenarios":"Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/config/PluginConfigService.java:76 when the library encounters an invalid state.","commonSituations":"The runtime persisted plugin config source is not available.","solutions":["Check the server/plugin configuration and enable the required module or use a supported alternative."],"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"}