ErrLookup › alibaba/nacos
alibaba/nacos
an easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications. · Java · 3,666 source files
Analyzed at 9b989acdf1 on 2026-08-14. 584 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| must not be null | validation | error | ai-agent, validation, null-check, required-field |
| Runtime Version range must be canonical | validation | error | ai-agent, validation, version-range, canonical, runtime-snapshot |
500 can not get security credentials, responseCode | exception | error | auth, ram, sts, network, credentials |
| Unlock rejected by server, key= | exception | error | lock, server-reject, distributed-lock, lease-expiry, watchdog |
| Invalid AgentResourceExt | exception | error | ai-registry, agent, deserialization, schema-mismatch |
403 Code: , Message: . | exception | error | auth, authentication, java, grpc, remote-filter, sdk, security |
SERVER_ERROR {unexpectedExceptionMessage} | exception | error | auth, visibility, remote-call, network, standalone-console |
| Failed to unlock | exception | error | lock, network, grpc, distributed-lock, transport-error |
| The number of capturing groups in the pattern segment | validation | error | antpathmatcher, uri-template, regex, resource-matching, validation |
| Invalid or expired state parameter | exception | error | auth, oidc, csrf, state, expired, hmac, access-denied, java |
| Invalid namespaceId | validation | error | ai-agent, validation, namespace, format |
| Runtime Endpoint state must be | validation | error | ai-agent, validation, state-invariant, runtime-snapshot |
| Code: , Message: . | http | error | auth, authorization, java, web-filter, permissions, http |
| Required config missing: token.secret.key | validation | critical | auth, config, startup, security, token |
| versionRange must contain runtimeVersion | validation | error | ai-agent, validation, version-range, runtime-snapshot, bindings |
| Runtime Endpoint bindings must not be empty | validation | error | ai-agent, validation, runtime-snapshot, bindings |
{result.getCode()} {remoteResultMessage} | exception | error | auth, remote-call, error-propagation, http-result |
MCP_SERVER_VERSION_EXIST Mcp Server and target version already exist, do not do release | exception | warning | ai, mcp-server, grpc, conflict, release, version, duplicate |
| HTTP | http | error | sse, copilot, prompt-debug, typescript, network, react |
400 could not determine a constructor for the tag | validation | error | config, yaml, serialization, metadata, import-export, invalid-param |
MCP_SERVER_REF_ENDPOINT_SERVICE_NOT_FOUND The Mcp Server Ref endpoint service not found. | exception | error | ai, mcp-server, grpc, configuration, endpoint, not-found |
| Unknown field | validation | error | validation, ai-agent, json-schema, serialization, schema-evolution |
20002 agentCard is invalid. Can't be parsed. | validation | error | a2a, agent, validation, ai-registry, deserialization |
50001 Invalid auth type, Please set `nacos.plugin.auth.type` (legacy alias… | error_code | critical | auth, config, java, startup, open-api, bootstrap |
| [NACOS HTTP-GET] The maximum number of tolerable server… | exception | critical | network, config, http-get, client, retry-exhausted |
| Management or declared Endpoint forbids healthy | validation | error | ai-agent, validation, endpoints, field-reserved |
| declaredEndpoints exceeds | validation | error | ai-agent, validation, capacity-limit, endpoints |
{} {} | exception | error | grpc, client, remote, error-response, server-side |
| LDAP auth plugin requires… | exception | critical | auth, ldap, classpath, plugin, missing-dependency, config, java |
| Duplicate declared Endpoint | validation | error | ai-agent, validation, duplicate, endpoints |
| [http-client] invalid read timeout | validation | critical | configuration, client-init, timeout, static-initializer |
| Snapshot binding does not match selected Version | validation | error | ai-agent, validation, version-range, runtime-snapshot, bindings |
| Current thread does not hold the lock | exception | error | lock, thread-local, reentrant, illegal-state, distributed-lock |
API_FUNCTION_DISABLED Nacos AI MCP module and API required both `naming` and `config` module. | exception | error | ai, mcp, noop-handler, module-disabled, function-mode, list |
50310 fuzzy watch pattern over limit | error_code | error | naming, fuzzy-watch, over-limit, quota, configuration |
| Cumulative Weight calculate wrong , the sum of… | exception | critical | naming, load-balancing, weight, floating-point, chooser, client |
| Duplicate Runtime Version binding | validation | error | ai-agent, validation, duplicate, runtime-snapshot, bindings |
| NacosLockService has been shut down | exception | error | lock, lifecycle, shutdown, illegal-state, resource-management |
PARAMETER_VALIDATE_ERROR Only reviewing version can be published | validation | error | ai-registry, version-lifecycle, publish, validation |
| Token secret key change requires restart | validation | error | auth, token, jwt, configuration, secret-key |
-400 wrong group name prefix of instance service name! it should be | exception | error | naming, group-name, validation, compatibility-mode, invalid-param |
| Nacos auth plugin has not been initialized | exception | critical | auth, token, jwt, lifecycle, initialization |
| Failed to delete legacy latest mirror for prompt | exception | error | prompt, server-error, storage, legacy, delete, config-service, nacos-ai |
PARAMETER_MISSING Required parameter `mcpName` not present | validation | error | mcp, validation, client-sdk, ai, parameter-missing |
| AI resource recall exceeded configured candidate limit | exception | critical | search, recall, server-error, configuration, vector, storage-dialect |
| Illegal base64 character | validation | error | auth, base64, encoding, validation, token |
| Nonce mismatch: expected | exception | critical | auth, oidc, nonce, replay-attack, security, csrf, access-denied, java |
| invalid token, username is empty | exception | error | auth, token, jwt, validation |
| Illegal url path expression | validation | error | http-client, validation, url-construction, context-path |
| unsupported Algorithm | exception | critical | auth, ram, crypto, jce-provider, signing |
| Lock interrupted | exception | error | lock, distributed, interruption, concurrency |
RESOURCE_NOT_FOUND AI resource import operator not found | exception | error | ai, importer, operator, not-found, server-error |
| Invalid boolean value | validation | error | configuration, type-conversion, validation, boolean |
| Input array too big, the output array would be bigger | validation | warning | base64, encoding, validation, size-limit |
21006 not match any type of selector! | validation | error | naming, selector, validation, admin-api, cmdb |
503 Runtime Endpoint result exceeds 1000 natural keys | exception | error | ai-agent, runtime-discovery, capacity-limit, scalability |
ACCESS_DENIED No permission to manage visibility grants for resource | exception | error | auth, visibility, authorization, access-denied, rbac |
| Agent directory metadata is only allowed when creating the… | validation | error | agent, draft, illegal-argument, metadata, version, validation |
| [http-client] invalid connect timeout | validation | critical | configuration, timeout, startup, validation, client |
-401 Interrupted while shutting down service info disk cache refresher | exception | warning | naming, disk-cache, shutdown, interrupted, lifecycle |
| is invalid IP | validation | warning | network, ip-parsing, validation, ipv4, ipv6 |
| Built-in LDAP auth plugin is not available | exception | critical | auth, ldap, plugin, spi, spring, illegal-state, wiring, java |
| e.getErrMsg() | exception | error | auth, permission, remote, cluster, network |
| unsupported action | validation | warning | auth, visibility, validation, action-normalization |
| Authentication failed | exception | error | auth, oidc, generic-catch, token-exchange, access-denied, java |
| must be a non-negative integer | validation | error | ai-agent, validation, timestamp, required-field |
| InvalidKey | exception | critical | auth, ram, crypto, credentials, signing |
| Failed to initiate login | exception | error | auth, oidc, generic-catch, login, uri, access-denied, java |
| Duplicate runtime Endpoint | validation | error | ai-agent, validation, duplicate, runtime-snapshot, endpoints |
| Invalid Agent Version status | validation | error | ai-agent, validation, status-lifecycle, illegal-argument |
| Runtime EndpointSet Version must not be null | validation | error | ai-agent, runtime-discovery, validation, rad |
| Nonce not present in ID token. Set… | exception | error | auth, oidc, nonce, replay-protection, config, access-denied, java |
501 Request Nacos server version is too low, not support fuzzy watch feature. | exception | error | naming, fuzzy-watch, version-mismatch, ability-negotiation, server-not-implemented |
| Condition not supported in Nacos distributed lock | exception | error | lock, condition, unsupported-operation, distributed-lock, api-limitation |
| user ' ' not found! | validation | warning | auth, role, validation, user-management |
| Invalid agentName | validation | error | ai-agent, validation, agent-name, length-limit, required-field |
| converter not found, can't convert from String to | exception | warning | type-conversion, configuration, internal-api, unsupported-type |
| File format invalid | validation | error | openapi, validation, format, swagger |
INVALID_PARAM parameter `type` should be | exception | warning | ai, a2a-agent, grpc, validation, endpoint, parameter |
| The addressing mode exists | validation | error | cluster, addressing-mode, configuration, illegal-argument |
| Unable to serialize Agent extensions | validation | error | ai-registry, agent, extensions, serialization |
| No available server after | exception | critical | network, maintainer-client, retry, server-unavailable, http-proxy |
| Unsupported SQL: . Nacos only support DML and some DDL SQL. | validation | error | persistence, embedded, sql, limiter, security |
50002 Empty identity, Please set `nacos.core.auth.server.identity.key` and… | error_code | critical | auth, config, java, startup, admin-api, identity, security |
| action is blank | validation | warning | auth, visibility, validation, action-normalization |
| signWithhmacSHA1Encrypt fail | exception | error | auth, ram, crypto, signing, spas |
| agent.versionRequired | validation | error | agent, typescript, react, routing, validation |
| user not found | exception | error | auth, ldap, persistence, database, generic-catch, java |
10000 Request parameter `agentSpecName` should not be blank. | validation | error | ai-agent, validation, protocol-version, ascii, illegal-argument |
304 not modified | exception | info | nacos, ai-client, http, not-modified, conditional-request, skill-download |
-503 More than client-side current limit threshold | exception | warning | config, rate-limit, client, qps, throttle |
| distroThreshold can not be zero or negative | validation | warning | naming, switch, distro, threshold, validation, configuration |
DATA_ACCESS_ERROR AI resource import plugin returned null service | exception | error | ai, importer, plugin, spi, server-error |
| Failed to acquire lock | exception | error | lock, distributed, grpc, network, connection |
PARSING_DATA_FAILED Failed to parse zip file: " + e.getMessage() | exception | error | skill, zip-parsing, parse-error, catch-all |
INSTANCE_METADATA_ERROR metadata format incorrect | validation | error | naming, metadata, validation, instance |
| serverList is empty,please check configuration | exception | critical | naming, configuration, server-list, startup, no-servers |
| Ambiguous methods mapped for | exception | error | spring-mvc, controller, ambiguous-mapping, legacy-resolver |
| invalid dataId | validation | error | nacos, config-client, group-key, validation, illegal-argument |
| Agent direct-online request must contain callInterfaces | validation | error | agent, direct-online, illegal-argument, call-interfaces, validation, version |