alibaba/nacos · error · PluginConfigApplyException

Static plugin config was refreshed but failed to apply: {plu

Error message

Static plugin config was refreshed but failed to apply: {pluginId}

What it means

Error "Static plugin config was refreshed but failed to apply: {pluginId}" thrown in alibaba/nacos.

Source

Thrown at core/src/main/java/com/alibaba/nacos/core/plugin/config/PluginConfigService.java:145

     * Refresh runtime-effective static configuration and apply an effective change.
     *
     * @param pluginInfo plugin info
     * @param pluginInstance plugin instance
     */
    public void refreshStaticConfig(PluginInfo pluginInfo, Object pluginInstance) {
        synchronized (getPluginLock(pluginInfo.getPluginId())) {
            resolver.refreshStaticConfig(pluginInfo);
            PluginConfigResolution resolution = resolver.resolve(pluginInfo, false);
            if (resolution.getConfig().equals(pluginInfo.getConfig())) {
                return;
            }
            try {
                checker.validateEffectiveConfig(pluginInfo, resolution.getConfig());
                applier.apply(pluginInfo.getPluginId(), pluginInstance, resolution.getConfig());
            } catch (RuntimeException e) {
                LOGGER.error("[PluginConfigService] Static plugin config was refreshed but failed "
                    + "to apply, pluginId={}", pluginInfo.getPluginId(), e);
                throw new PluginConfigApplyException("Static plugin config was refreshed but "
                    + "failed to apply: " + pluginInfo.getPluginId(), e);
            }
            pluginInfo.setConfig(copyConfig(resolution.getConfig()));
        }
    }
    
    /**
     * Replace and apply the local-only source snapshot.
     *
     * @param pluginInfo plugin info
     * @param pluginInstance plugin instance
     * @param config normalized full override map
     */
    public void updateLocalOnlyConfig(PluginInfo pluginInfo, Object pluginInstance,
        Map<String, String> config) {
        replaceAndApply(pluginInfo.getPluginId(), pluginInfo, pluginInstance,
            PluginConfigSourceType.LOCAL_ONLY, config, true);
    }

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/config/PluginConfigService.java:145 when the library encounters an invalid state.

Common situations: Applying refreshed static plugin configuration failed.

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