alibaba/nacos
Documented errors, page 2 of 6. Back to alibaba/nacos
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
SERVER_NOT_IMPLEMENTED Request Nacos server does not support | exception | error | ai, grpc, ability-negotiation, version-mismatch, not-implemented |
| Unable to build SslContext | exception | error | grpc, tls, ssl, netty, certificates |
{response.getErrorCode()} http error, code= ,msg= ,dataId= ,group= ,tenant= | exception | error | config, server-error, client, get-config |
| Invalid Agent Version storage descriptor | validation | error | java, nacos, ai-agent, serialization, json, data-corruption, storage-descriptor |
| [NACOS HTTP-POST] The maximum number of tolerable server… | exception | critical | network, config, http-post, client, retry-exhausted |
| Plugin selection for exclusive type | validation | warning | plugin, exclusive, restart-required, validation |
| Jackson 3 is not available on the runtime classpath. | exception | critical | classpath, jackson3, dependency, init |
| Missing AgentResourceExt field: versionCatalog | validation | error | validation, ai-agent, json-schema, serialization |
MCP_SERVER_NOT_FOUND MCP server ` ` not found in namespaceId | exception | warning | ai, mcp-server, grpc, not-found, endpoint |
| username is blank | validation | error | auth, validation, visibility, illegal-argument, java |
| illegal version, must match | validation | warning | naming, switch, push-version, regex, format, validation, configuration |
| role not found! | validation | warning | auth, permission, role, validation, cache |
| User not found | exception | warning | auth, user-management, login, remote, spring-security |
| Duplicate Version label | validation | error | ai-agent, validation, labels, catalog, uniqueness, illegal-argument |
| Pre-context plugin requires restart | validation | warning | plugin, pre-context, restart-required, validation |
| Failed to request API | exception | error | ai, http, retry, all-servers-failed, agent-api, network |
100 Nacos serialize for class | error_code | error | serialization, jackson3, json, runtime |
| Authorization endpoint not configured | exception | error | auth, oidc, config, discovery, metadata, access-denied, java |
| Invalid | validation | error | ai-agent, validation, uri, length-limit |
| raw callInterfaces cannot be converted to a structured… | validation | error | conversion, protocol, agent, state |
| Recursive unlock() detected for key= | exception | error | lock, distributed, reentrancy, unlock, concurrency |
| AI resource Version row is invalid | exception | critical | data-integrity, server-error, delete, corruption, ai-resource |
| Non-reentrant lock does not allow reentry on the same… | exception | error | lock, distributed, non-reentrant, reentrancy, client-guard |
| Unable to serialize AgentVersionContent | validation | error | serialization, agent-version, storage, illegal-argument |
| session expired! | exception | error | auth, session, http, unauthorized |
21009 Service is not empty, can't be delete. Please unregister instance first | validation | error | naming, service-delete, not-empty, instances, validation |
{e.getErrCode()} Get Running Client failed: | exception | error | config, grpc, capability, client, connection |
| fuzzy watch result future timeout for | exception | warning | naming, fuzzy-watch, timeout, future, initialization |
| Cannot create a relative resource for | exception | error | resource, io, file, api-surface |
| dataId= , group= | validation | error | config, cache-data, validation, client |
| HTTP + response.getStatusCode() + when fetching +… | http | error | ai-registry, skill, network, http, importer |
21004 service not found, namespace | validation | error | naming, instance, not-found, validation, admin-api |
| failed to create cache | exception | error | naming, disk-cache, filesystem, io, permissions |
NOT_MODIFIED not modified | exception | info | nacos, ai-client, http, not-modified, conditional-request, cache |
20004 clientId [ ] not exist | http | error | naming, client-management, not-found, admin-api, connection |
CONFLICT AgentCard name already exist | exception | error | a2a, agent, conflict, duplicate, create, config |
| cannot be resolved to URL | exception | error | resource, io, url, api-surface |
| Illegal url path expression | validation | error | configuration, validation, context-path, client-init |
| latest label must be absent when no online Version exists | validation | error | ai-agent, validation, version-info, labels, consistency, illegal-argument |
| Cannot get LocalHost InetAddress, please check your network! | exception | critical | id-generator, snowflake, network, startup, inet, configuration |
| Duplicate protocol for Agent Version | validation | error | validation, ai-agent, version-catalog, protocols, deduplication |
| json param invalid. | validation | error | naming, switch, validation, json, health-params |
| role 'ROLE_ADMIN' is not permitted to create! | validation | warning | auth, role, validation, reserved, admin |
| role 'ROLE_ADMIN' is not permitted to delete! | validation | error | auth-plugin, role-management, reserved-role, admin, input-validation |
| delete fail | exception | warning | io, filesystem, file-lock, windows, permissions |
| no available server | exception | critical | network, config, http-get, client, timeout |
| Online Version label is missing from versionCatalog | validation | error | ai-agent, validation, version-info, labels, catalog, consistency, illegal-argument |
| Prompt is required | validation | error | copilot, prompt-debug, java, validation, form |
| role '__nacos_anonymous_role__' is reserved by the system | validation | warning | auth, role, validation, reserved, anonymous |
| illegal format, must be 'type:version', but got | validation | warning | naming, switch, push-version, format, validation, configuration |
| LDAP login failed. | exception | error | auth, ldap, access-denied, bind-failure, config, java |
OVER_THRESHOLD Legacy A2A Endpoint batch exceeds | exception | error | a2a, endpoint, batch-limit, over-threshold, naming, capacity |
| invalid groupkey | validation | error | nacos, config-client, group-key, validation, illegal-argument, encoding |
| Online Agent Version protocols must contain 1 to 16 values | validation | error | validation, ai-agent, version-catalog, protocols |
| Param 'resourcePattern' is illegal, resourcePattern is blank | validation | warning | fuzzy-listen, validation, configuration, naming, blank-check |
{restResult.getCode()} {restResult.getMessage()} | exception | error | nacos, ai-client, http, server-error, skill-download |
| Background information is required | validation | error | copilot, skill-generation, java, validation, form |
| is required | validation | warning | validation, agent, required-field, frontend |
| Runtime EndpointSet Versions must not be empty | validation | error | validation, agent-runtime, rad-discovery, illegal-argument |
| Version catalog label does not match versionInfo | validation | error | ai-agent, validation, version-info, labels, catalog, consistency, illegal-argument |
| Unsupported http method | validation | error | http-client, validation, http-method, enum |
{exception.getErrCode()} Failed to request API | exception | error | nacos, ai-client, http, network, retry-exhaustion, agentspec-query |
| expired token | exception | error | auth, token, jwt, expiry |
| Legacy A2A Endpoint address must not be empty | exception | error | a2a, endpoint, validation, address, invalid-param |
| role 'ROLE_ADMIN' already exist ! | validation | warning | auth, role, admin, duplicate, bootstrap |
| unsupported client type | validation | error | naming, switch, validation, push-version |
| callInterfaces must contain 1 to | validation | error | ai-agent, validation, call-interface, capacity-limit, illegal-argument |
| must contain 1 to values | validation | error | ai-agent, validation, protocols, capacity-limit, illegal-argument |
| httpClientFactory is null | exception | error | http-client, null-check, validation, internal-api |
| invalid probeModify | validation | error | config, listener, client-protocol, validation |
| list size must be a multiple of 2 | validation | error | http-client, validation, header, argument |
| not support to cancel fuzzy watch | exception | warning | naming, fuzzy-watch, future, unsupported-operation, api-limitation |
101 Nacos deserialize for class | error_code | error | deserialization, jackson, json, runtime |
| Agent extensions contains a non-string JSON object key | validation | error | ai-registry, agent, extensions, type-violation |
| Plugin config value cannot be null | validation | error | auth, ldap, config, validation, illegal-argument, java |
| Agent replacement must not be null | validation | error | agent, null-check, illegal-argument, update, programming-error |
| Built-in OIDC auth plugin is not available | exception | critical | oidc, plugin, startup, spi, spring |
| pageNo and pageSize must be greater than zero | validation | warning | pagination, embedded-db, auth-plugin, input-validation, derby |
| Password length must not exceed | validation | warning | auth, password, validation, input-limits |
CLIENT_DISCONNECT AI client connection already disconnected | exception | critical | a2a, endpoint, client-connection, disconnect, grpc, runtime-exception |
| cannot be resolved in the file system for checking its… | exception | error | resource, io, file, classpath |
| Invalid JSON/YAML format | validation | error | parsing, openapi, validation, json, yaml, input-format |
RESOURCE_CONFLICT No editing draft to overwrite | exception | error | upload, conflict, draft, lifecycle, skill |
| Plugin config value cannot be null: + key | validation | error | config, validation, null-handling |
| cannot be resolved to absolute file path | exception | error | resource, io, file, api-surface |
| agent.labelsObjectRequired | validation | error | validation, labels, json, agent |
| editingVersion and reviewingVersion must not identify… | validation | error | ai-agent, validation, version-info, consistency, illegal-argument |
| endpointSourceOrder must contain 1 or 2 sources | validation | error | ai-agent, validation, endpoint, call-interface, illegal-argument |
| cannot be resolved in the file system for checking its… | exception | error | resource, io, file, lifecycle |
| file not exist | exception | error | disk, file-io, concurrency, filesystem, client |
| [http-client] invalid auth refresh interval | exception | error | configuration, maintainer-client, auth, number-format, initialization |
| Path escapes target directory | exception | critical | java, nacos, ai, skills, security, path-traversal, filesystem |
| The subscriber has no event publisher | exception | warning | event-bus, notify-center, subscriber, lifecycle |
| username '__nacos_anonymous__' is reserved by the system | validation | warning | auth, user-management, validation, reserved-name |
50100 Agent not found | exception | error | a2a, agent, not-found, namespace, config-query |
| unsupported signature algorithm | exception | error | auth, jwt, algorithm, security |
| Agent direct-online request must not be null | validation | error | agent, null-check, illegal-argument, direct-online, programming-error |
| extensions exceeds entries | validation | error | ai-agent, validation, capacity-limit, extensions, illegal-argument |
| Failed to install JRaft authentication interceptor | exception | critical | raft, jraft, grpc, interceptor, auth, startup, cp-protocol |
| must be an integer | validation | error | validation, ai-agent, json-schema, serialization |