alibaba/nacos · error · NacosApiException

API_FUNCTION_DISABLED

API_FUNCTION_DISABLED

Error message

Current functionMode is `config`, naming module is disabled.

What it means

Error "Current functionMode is `config`, naming module is disabled." thrown in alibaba/nacos.

Source

Thrown at console/src/main/java/com/alibaba/nacos/console/handler/impl/noop/naming/ServiceNoopHandler.java:49

import java.util.List;

/**
 * Noop Implementation of ServiceHandler that handles service-related operations.
 * Used when `naming` module is disabled(functionMode is `config`)
 *
 * @author xiweng.yy
 */
@org.springframework.stereotype.Service
@ConditionalOnMissingBean(value = ServiceHandler.class, ignored = ServiceNoopHandler.class)
public class ServiceNoopHandler implements ServiceHandler {
    
    private static final String MCP_NOT_ENABLED_MESSAGE =
        "Current functionMode is `config`, naming module is disabled.";
    
    @Override
    public void createService(ServiceForm serviceForm, ServiceMetadata serviceMetadata)
        throws Exception {
        throw new NacosApiException(NacosException.SERVER_NOT_IMPLEMENTED,
            ErrorCode.API_FUNCTION_DISABLED,
            MCP_NOT_ENABLED_MESSAGE);
    }
    
    @Override
    public void deleteService(String namespaceId, String serviceName, String groupName)
        throws Exception {
        throw new NacosApiException(NacosException.SERVER_NOT_IMPLEMENTED,
            ErrorCode.API_FUNCTION_DISABLED,
            MCP_NOT_ENABLED_MESSAGE);
    }
    
    @Override
    public void updateService(ServiceForm serviceForm, ServiceMetadata serviceMetadata)
        throws Exception {
        throw new NacosApiException(NacosException.SERVER_NOT_IMPLEMENTED,
            ErrorCode.API_FUNCTION_DISABLED,
            MCP_NOT_ENABLED_MESSAGE);

View on GitHub (pinned to 9b989acdf1)

Solutions

1. Check the server/plugin configuration and enable the required module or use a supported alternative.

When it happens

Trigger: Thrown at console/src/main/java/com/alibaba/nacos/console/handler/impl/noop/naming/ServiceNoopHandler.java:49 when the library encounters an invalid state.

Common situations: Calling naming console APIs while the server runs in config-only function mode.

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