3.3.0(Oct 29th, 2026)
Nacos 3.3.0 is a feature iteration release for the Nacos 3.x series. It brings protocol-neutral Agent management and discovery, shared AI resource search, and unified MCP lifecycle management to the stable release.
This release focuses on:
- AI Registry capabilities across Agent, AgentSpec, Skill, Prompt, and MCP resources.
- DNS service discovery and distributed locks.
- Dynamic plugin management and authentication enabled by default.
- Spring Boot 4 and Jackson 3 compatibility, with improved client and server reliability.
The main feature updates include:
- Agent registration, version management, runtime endpoints, RAD discovery, transport negotiation, and Watch/Push through Java SDKs and Console workflows.
- Shared AI resource search with hybrid keyword and vector retrieval, artifact access, and optional relevance filtering.
- MCP draft, review, publish, online/offline, and visibility management, with migration support for historical resources.
- Optional DNS discovery with A, AAAA, and SRV records over UDP and TCP.
- Distributed reentrant and non-reentrant locks with watchdog renewal and Raft consistency.
The stable release also improves Skill metadata consistency across version transitions, extends visibility plugin capabilities, and strengthens Config SDK usability, Console compatibility, and recovery after Naming reconnects and cluster restarts.
These notes are cumulative and include the changes delivered in 3.3.0-BETA and 3.3.0-RC.
Detailed changes in this release:
- #50 Add optional DNS service discovery over UDP and TCP, with A, AAAA, and SRV records, metrics, and configurable external DNS forwarding.
- #14466 Add a neutral JSON adapter with Jackson 2 and Jackson 3 runtime support.
- #14804 Add protocol-neutral Agent lifecycle management, Console workflows, RAD discovery, runtime endpoints, transport negotiation, Watch/Push, and Java SDKs.
- #15279 Add distributed reentrant and non-reentrant locks with watchdog renewal, FIFO waiting, gRPC notifications, Raft consistency, and a Java Lock SDK.
- #15471 Support SkillSpector as an AI publish pipeline.
- #15475 Add unified dynamic plugin configuration, lifecycle management, runtime updates, deterministic discovery, and Console configuration workflows.
- #15476#15604 Add plugin-owned visibility grant and revoke APIs and Console management for Skill and AgentSpec resources.
- #15541 Add Agentic Resource Discovery with search, exploration, artifact retrieval, visibility filtering, persistent indexes, and hybrid keyword and vector retrieval.
- #15640 Add Linux RISC-V64 compatibility for RocksDB JNI loading and startup.
- #15761 Add shared MCP lifecycle management with drafts, review, publish, online/offline operations, visibility, Java SDKs, and historical reconciliation while preserving existing Config/Naming serving data.
- #8354 Replace the mandatory Prometheus client dependency with a pluggable client metrics SPI and a no-op default.
- #12064 Support configuring the gRPC port offset through individual client properties.
- #12734 Add request/result-based Config SDK methods, encrypted Config CAS publishing, and conditional queries with local cache reuse.
- #13690 Log the resolved client logging configuration and include namespace IDs in subscription logs.
- #14804 Improve Agent Console workflows, expose SDK discovery capabilities and A2A conversion helpers, and trace discovery request origins.
- #14817 Disable selected deprecated Pipeline and MCP import APIs by default and provide a shared temporary compatibility switch.
- #14932 Reduce read-path contention and improve index consistency in the legacy MCP cache.
- #14980 Support deregistering persistent Naming instances from Console v3.
- #15315#15561 Improve Skill upload precheck, conflict handling, and server-side ZIP validation.
- #15322 Remove obsolete Config migration compatibility code and retain only the current Config storage model.
- #15345 Return cached Skill frontmatter in list and metadata-detail responses.
- #15346 Manage the reserved
latestlabel for AI resources on the server. - #15357 Enable Client API authentication by default and validate standard integration scenarios with authentication enabled.
- #15432#15440#15441 Remove reviewed unused Java code while preserving required compatibility contracts.
- #15448 Improve English translations in Console UI Next.
- #15486 Include the Skill owner in upload permission-denied messages.
- #15606 Return a stable per-item result for every Skill batch upload candidate.
- #15661 Restrict distributed embedded database query results to supported scalar types and registered row mappers.
- #15678 Decouple the visibility plugin SPI from server runtime modules.
- #15686#15692 Align authorization method resolution with Spring MVC routing and expand controller-level authorization regression coverage.
- #15687 Authenticate native JRaft gRPC requests with server identity and a rolling-upgrade enforcement transition.
- #15695 Improve Config detail, edit, and history page layouts with larger content areas and full-screen reading.
- #15720 Automatically publish the first uploaded Skill version.
- #15746 Add operator-controlled outbound access policies for MCP tool imports.
- #15837 Add opt-in initialization for multiple Spring AOT contexts and improve GraalVM runtime metadata.
- #15838 Clarify that rolling back the first inserted Config history record deletes the configuration.
- #15854 Remove untagged legacy Raft request parsing and preserve explicit errors for malformed log entries.
- #15868 Support disabling local Config snapshots through the
configSnapshotEnabledstartup property. - #15896 Migrate Copilot streaming to typed AgentScope events while preserving the existing SSE response contract.
- #15900 Correlate Java SDK HTTP requests with server request context through
Nacos-Request-Id. - #15903 Add a runnable Parallel Search MCP example for registration, endpoint discovery, web search, and page fetching.
- #15921 Add optional Jev relevance filtering for ARD Search, with stable result ordering and fallback to basic search.
- #15929 Add Russian localization and a language selector to Console UI Next.
- #15956 Allow visibility plugins to declare additional AI resource scopes and extend Agent validation through an optional SPI, while preserving default PUBLIC/PRIVATE behavior.
- #11122 Accept
healthCheckEnabledas a health-check switch entry while retaining the legacycheckalias. - #11780 Preserve Config and service list filters and pagination when returning from detail pages.
- #11890 Avoid removing metadata for instances that still exist after restart.
- #12557 Retry Config dump write-lock acquisition to prevent stale MD5 cache data.
- #14008 Fix native-image metadata required to establish gRPC client connections.
- #14804 Keep AI search available with partial results while indexes are being backfilled.
- #14804 Preserve Agent SDK Watches across transient failures and deliver initial and updated state through a consistent Listener path.
- #14981#15468 Fix concurrent Config publish duplicate-key handling through the datasource dialect SPI, including PostgreSQL
unique_violation. - #15410 Fix trailing separators when joining collections containing null elements.
- #15415 Prevent malformed config-plugin property names from discarding valid plugin configuration.
- #15420 Fix Skill ZIP uploads with invalid or unavailable version candidates.
- #15425 Prevent out-of-range batch indexes from causing
IndexOutOfBoundsException. - #15446 Fix page count calculation for empty and exactly divisible result sets.
- #15447 Prevent
NamingUtils.getServiceNamefrom failing on a trailing service separator. - #15466 Correct
@Sinceannotations for Skill upload APIs. - #15470 Prevent Naming connection cleanup from waiting for unrelated distributed-lock Raft writes.
- #15475 Fix standalone Console auth plugin initialization and forward the caller identity to downstream Server requests.
- #15476 Enforce Prompt visibility on list, detail, version, download, and Client read APIs.
- #15477 Wait for persistent service metadata before starting health checks.
- #15490 Fix Chinese text corruption in Skill Scanner pipeline reports on Windows.
- #15494 Restore complete MCP tool advanced-template support in Console UI Next.
- #15510 Reject explicitly supplied invalid Bearer tokens instead of falling back to anonymous access.
- #15534 Generate deterministic, ASCII-safe physical Config keys for AI resources.
- #15543 Restore case-sensitive collation for newly initialized MySQL Config schemas.
- #15557 Fix startup failures when plugin state snapshots are restored before unified plugin discovery.
- #15560 Preserve MCP tool passthrough authentication when editing and publishing runtime templates.
- #15603 Fix visibility query conversion when explicitly authorized resources are present.
- #15618 Try lower-priority explicit Skill upload versions before generating a version.
- #15620 Allow AI resource versions to be resubmitted after completed or stale review results.
- #15625 Fix gray Config cache null access and cross-thread visibility in Config disk services and client connections.
- #15634 Fix API authorization metadata, custom resource parser precedence, AgentSpec authorization, and Prometheus security path matching.
- #15642 Make AI resource deletion cleanup-first and retryable across all stored versions.
- #15658 Keep AI resource reads, updates, and deletion bound to the persisted storage provider.
- #15660 Fix standalone Console startup when the Config clone source-permission checker is unavailable.
- #15663 Preserve case-sensitive AI resource identities in MySQL search and task tables.
- #15675 Preserve nullable MCP tool output schemas during editing, display, and OpenAPI import.
- #15682 Prevent login responses from disclosing whether a username exists.
- #15689 Preserve string serialization of Config storage IDs with Jackson 3 to avoid numeric precision loss.
- #15701 Fix Config history next-record queries on Derby and preserve gray-version filtering.
- #15703 Migrate the legacy skills.sh importer state key without overriding canonical configuration.
- #15705 Clean removed Skill and AgentSpec draft files while retaining retry metadata after storage failures.
- #15710 Declare the required SQL LIKE escape clause for Derby, Oracle, and other affected dialects.
- #15712#15827 Reject unsafe instance addresses, HTTP targets, headers, and MySQL connection options in active health checks.
- #15714 Handle encoded context paths consistently in the legacy controller-method resolver.
- #15718 Escape all LIKE predicates when searching embedded roles with username filters.
- #15724 Forward the namespace when querying Config listeners by IP across cluster members.
- #15744 Align bootstrap and distribution configuration defaults.
- #15763 Reject invalid IPv6 mixed addresses with too many explicit address blocks.
- #15788 Allow the Java client to run with Jackson 3 after excluding Jackson 2 core/databind, including authentication paths.
- #15803 Reject unsafe AgentSpec and Skill ZIP layouts and enforce entry-count and decompression limits.
- #15804 Reject unsafe filesystem paths before Config, archive, and local rule-storage operations.
- #15821 Increase the embedded Derby connection timeout to prevent initialization failures on slow storage.
- #15836 Fix plugin availability RPC serialization so remote cluster members are reported correctly.
- #15844 Use the correct default gRPC protocol negotiator type.
- #15847 Restore public defaults for newly created Agent and MCP resources and preserve existing visibility scopes.
- #15850#15851 Select the default JDBC driver from the datasource dialect and clarify non-MySQL configuration examples.
- #15853 Return schema metadata in current, historical, and previous-version Config details.
- #15857 Prevent stale Distro snapshots from overwriting redo registrations and losing service instances after cluster restarts.
- #15864 Resolve HEAD requests through their GET mapping in the legacy controller-method cache.
- #15866 Remove server-list event subscriptions on client shutdown and prevent callbacks from accessing a closed server-list provider.
- #15872 Display subscriber addresses, client versions, and application names correctly in Console UI Next.
- #15876 Ignore registration responses from obsolete connections so ephemeral instances are re-registered after reconnect storms.
- #15883 Fix unexpected HTTP 403 responses from identity-only APIs when Console is deployed independently.
- #15899 Fix Console UI Next loading failures on Chromium 90 by transpiling unsupported JavaScript syntax.
- #15930 Prevent uncaught errors from permanently cancelling Naming redo tasks and blocking registration or subscription recovery.
- #15945#15947 Parse multiline YAML Skill descriptions correctly and prevent spurious frontmatter fields.
- #15946 Preserve empty and whitespace-only Skill resource files when reading versions and downloading packages.
- #15949 Keep Skill descriptions consistent with the displayed version across draft edits and lifecycle transitions, and retain the correct description when the last online version goes offline.
- #15953 Keep Publish and Cancel actions visible on Config creation and edit pages, and eliminate nested scrolling on Config and history detail pages in Console UI Next.
- #14944 Upgrade Spring Boot from 3.5.14 to 4.0.6.
- #15470 Upgrade SOFA JRaft to 1.4.1 while preserving callback cache behavior and JRaft authentication.
- #15584 Upgrade Maven Compiler Plugin from 3.5.1 to 3.15.0 for JDK 25 build compatibility.
- #15645#15834#15944 Update legacy and next Console dependencies, refresh packaged assets, and upgrade the bundled DOMPurify sanitizer to 3.4.17.
- #15707 Upgrade Log4j API from 2.25.4 to 2.25.5.
- #15767 Upgrade gRPC to 1.81.0 to address CVE-2026-33871.
- #15796 Upgrade Apache Derby from 10.14.2.0 to 10.16.1.1, align split artifacts, and retain the Java 17 baseline.
- #15878 Upgrade AgentScope Java from 1.0.7 to 2.0.3 in Copilot.
Nacos 3.3.0 changes authentication defaults, disables selected deprecated APIs, and introduces migration requirements. Applications using the new Agent SDK from BETA or RC also need to review the finalized subscription contract.
Affected users:
- Applications relying on Client APIs without credentials or on deprecated Pipeline and MCP import endpoints.
- Deployments with legacy Config data, historical AI storage keys, untagged Raft logs, or A2A/MCP resources requiring migration.
- Applications relying on built-in Prometheus client metrics or implicit AI resource visibility defaults.
- BETA/RC adopters using RAD subscriptions or remotely accessing the optional DNS server.
Recommended upgrade path:
- Prepare Client API credentials. An absent
nacos.core.auth.enablednow meanstrue. Existing explicitfalsesettings remain effective. If necessary, keep authentication explicitly disabled during credential provisioning, then enable it consistently across the cluster after verifying client access. Admin and Console authentication defaults are unchanged. - Migrate deprecated AI API calls. Selected legacy Pipeline and Console MCP import endpoints return HTTP
410withAPI_DEPRECATEDby default. Use the Pipeline/listand/detailendpoints and unified/v3/console/ai/import/validateand/executeendpoints.nacos.core.api.compatibility.enabled=truetemporarily reopens the selected endpoints;nacos.ai.resource.import.legacy-mcp-api-enabledis no longer recognized. - Complete legacy Config migrations. Upgrade pre-3.0 deployments through an earlier Nacos 3.x version. Migrate default-namespace data from the empty tenant to
public, and legacy beta/tag data toconfig_info_gray. For thenacos_configAI storage provider, explicitly migrate affected historical non-ASCII or overlength Config coordinates to the deterministic ASCII-safe mapping. - Check persisted Raft logs. Nacos 3.3 no longer replays untagged entries, including entries originally written by Nacos 2.0.x and retained through intermediate upgrades. Recover and migrate those logs or snapshots with a compatible version before upgrading; changing the running version alone does not convert persisted logs.
- Plan historical A2A and MCP migration. The default
nacos.ai.a2a.compatibility.mode=CANONICALdoes not scan historical A2A data. Follow the A2A upgrade runbook forAUTOmigration and early-3.3 preflight. After permanent canonical cutover, legacy-only servers must not rejoin. Preserve MCP reconciliation state and its existing Config/Naming serving data during the one-way lifecycle transition. - Keep cluster server identities consistent. Native JRaft authentication becomes enforced after all members advertise support, and enforcement persists across restarts. Rolling downgrades to members without JRaft credential support are not guaranteed to remain available.
- Update BETA/RC Agent SDK consumers. The new RAD
subscribeAgentmethods now returnvoid. Receive both initial state and subsequent updates through the Listener, prepare Listener state before subscribing, and recompile dependent applications. Legacy A2A signatures and HTTP/gRPC wire contracts remain unchanged. - Configure client metrics explicitly.
nacos-clientno longer includes a mandatory Prometheus client dependency. Install an implementation ofNacosClientMetricsProviderwhen metrics are required; without one, recording is a no-op even whenenableClientMetricsis enabled. - Review MCP import and visibility settings. Private or local MCP import targets require
nacos.console.ai.mcp.import.allowed-private-addresses, and redirects are not followed. The built-in visibility plugin defaults newly created Agent and MCP resources toPUBLIC; explicitly choose a private scope where required. Existing stored scopes and Prompt/Skill defaults are unchanged. - Review DNS listener configuration. DNS remains optional and disabled by default. When enabled,
nacos.naming.dns.bind-addressdefaults to127.0.0.1; configure the intended listening address for remote clients. External forwarding requires separate explicit configuration. - Refresh affected Skill metadata. Historical Skill descriptors without parsed frontmatter retain their existing metadata; this release does not automatically read their packages or backfill missing metadata. Update the content or re-upload affected Skills to regenerate frontmatter and correct previously stored multiline descriptions.
- Back up and rehearse the upgrade. Back up the database and persisted server data, then verify authentication, data migration, discovery, and client behavior in staging. Embedded Derby is upgraded to 10.16.1.1, so include persisted-data reads, subsequent writes, and restart recovery in upgrade validation.
Deployments without the affected historical data do not require those data migrations. The authentication defaults and any applicable API or SDK changes still need review.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 17 |
| Nacos-Client | Java 8 |
| Nacos-Maintainer-Client | Java 8 |
- @lzcGeek made their first contribution in https://github.com/alibaba/nacos/pull/15874
- @FOWEPJF255 made their first contribution in https://github.com/alibaba/nacos/pull/15916
- @bespaltovyj made their first contribution in https://github.com/alibaba/nacos/pull/15938
- @soeben made their first contribution in https://github.com/alibaba/nacos/pull/15940
- @Lyin-OTTF made their first contribution in https://github.com/alibaba/nacos/pull/15941
- @AsyncKurisu made their first contribution in https://github.com/alibaba/nacos/pull/15919
- @georgeatparallel made their first contribution in https://github.com/alibaba/nacos/pull/15926
Full Changelog: https://github.com/alibaba/nacos/compare/3.3.0-RC...3.3.0
2.5.5 (Oct 29th, 2026)
Nacos 2.5.5 is mainly a bugfix and experience-improvement release for the 2.x series.
This release focuses on:
- Hardening server disk paths and active HTTP health checks.
- Preventing service instance loss during full cluster restarts.
- Fixing gRPC frame corruption while preserving Java 8 compatibility.
- Improving HTTP request handling and cluster member consistency.
Detailed changes in this release:
- #15809 Harden server disk path validation for Config storage, local TPS rules, and ZIP extraction to prevent access outside intended directories.
- #15828 Harden active HTTP health checks by validating request targets and custom headers and restricting checks to the registered instance target.
- #15857 Fix permanent service instance loss during full cluster restarts by excluding connection-based clients from Distro snapshots that can overwrite new registrations.
- #15865 Fix controller method lookup for HTTP HEAD requests by resolving them to the corresponding GET mappings.
- #15951 Fix inconsistent cluster member hashing by aligning
hashCode()with the address-based comparison used byequals().
- #15936 Upgrade gRPC to 1.78.0 to fix frame corruption causing false message-size and mid-frame end-of-stream errors, while retaining Guava 33.3.1-android for Java 8 compatibility.
This release strengthens validation for disk paths and active HTTP health checks. Before upgrading, review the following configurations:
- Config identity fields must not be exactly
.or... Local TPS rule names must be valid file names without path separators or directory traversal components. - HTTP health-check targets must use relative URI references, such as
/healthwith optional query parameters, without a scheme, authority, or fragment. Custom headers must be valid and must not includeContent-LengthorTransfer-Encoding.
Existing HTTP health checks that fail the new validation are skipped without sending requests or changing instance health status. Update affected configurations to restore health checking.
Deployments using valid identifiers and health-check configurations require no changes for these validation updates.
Nacos 2.5.5 retains the Java 8 baseline used by the 2.x series.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 8 |
| Nacos-Client | Java 8 |
Full Changelog: https://github.com/alibaba/nacos/compare/2.5.4...2.5.5
3.3.0-RC
Nacos 3.3.0-RC is a release candidate for the Nacos 3.3 feature iteration. It builds on 3.3.0-BETA with expanded AI Registry capabilities, DNS service discovery, and further security and compatibility improvements.
This release focuses on:
- Protocol-neutral Agent management and RAD discovery, including transport negotiation and Watch/Push.
- Shared AI resource search and unified MCP lifecycle management.
- DNS-based service discovery and Config SDK improvements.
- Authentication enabled by default, migration safeguards, and runtime stability.
The main feature updates include:
- Agent registration, endpoint publication, discovery, Java SDKs, and Console management, with a migration path for historical A2A data.
- Search and discovery across Agent, AgentSpec, Skill, Prompt, and MCP resources, including shared indexes and artifact retrieval.
- MCP draft, review, publish, online/offline, and visibility management while retaining existing serving contracts.
- Optional DNS A-record queries over UDP and TCP.
The release also retains BETA's dynamic plugin management, distributed locks, Jackson 2/3 support, and Spring Boot 4 compatibility. It includes further fixes across Config, Naming, Console, clients, AI storage, and authorization.
These notes are cumulative for 3.3.0 and include the changes documented in 3.3.0-BETA.
Detailed changes in this release:
- #50 Add optional DNS service discovery with A-record queries over UDP and TCP.
- #14466 Add a neutral JSON adapter with Jackson 2 and Jackson 3 runtime support.
- #14804 Add protocol-neutral Agent lifecycle management, Console workflows, RAD discovery, runtime endpoints, transport negotiation, Watch/Push, and Java SDKs.
- #15279 Add distributed reentrant and non-reentrant locks with watchdog renewal, FIFO waiting, gRPC notifications, Raft consistency, and a Java Lock SDK.
- #15471 Support SkillSpector as an AI publish pipeline.
- #15475 Add unified dynamic plugin configuration, lifecycle management, runtime updates, deterministic discovery, and Console configuration workflows.
- #15476#15604 Add plugin-owned visibility grant and revoke APIs and Console management for Skill and AgentSpec resources.
- #15541 Add Agentic Resource Discovery with search, exploration, artifact retrieval, visibility filtering, persistent indexes, and hybrid keyword and vector retrieval.
- #15640 Support Nacos server deployments on Linux RISC-V with RocksDB.
- #15761 Add shared MCP lifecycle management with drafts, review, publish, online/offline operations, visibility, Java SDKs, and historical reconciliation while preserving existing Config/Naming serving data.
- #8354 Replace the mandatory Prometheus client dependency with a pluggable client metrics SPI and a no-op default.
- #12064 Support configuring the gRPC port offset through individual client properties.
- #12734 Add request/result-based Config SDK methods, encrypted Config CAS publishing, and conditional queries with local cache reuse.
- #13690 Log the resolved client logging configuration and include namespace IDs in subscription logs.
- #14804 Improve Agent detail, draft creation, version history, and legacy A2A Console workflows.
- #14817 Disable selected deprecated Pipeline and MCP import APIs by default and provide a shared temporary compatibility switch.
- #14932 Reduce read-path contention and improve index consistency in the legacy MCP cache.
- #14980 Support deregistering persistent Naming instances from Console v3.
- #15315#15561 Improve Skill upload precheck, conflict handling, and server-side ZIP validation.
- #15322 Remove obsolete Config migration compatibility code and retain only the current Config storage model.
- #15346 Manage the reserved
latestlabel for AI resources on the server. - #15357 Enable Client API authentication by default and validate standard integration scenarios with authentication enabled.
- #15432#15440#15441 Remove reviewed unused Java code while preserving required compatibility contracts.
- #15448 Improve English translations in Console UI Next.
- #15486 Include the Skill owner in upload permission-denied messages.
- #15606 Return a stable per-item result for every Skill batch upload candidate.
- #15661 Restrict distributed embedded database query results to supported scalar types and registered row mappers.
- #15678 Decouple the visibility plugin SPI from server runtime modules.
- #15686#15692 Align authorization method resolution with Spring MVC routing and expand controller-level authorization regression coverage.
- #15687 Authenticate native JRaft gRPC requests with server identity and a rolling-upgrade enforcement transition.
- #15695 Improve Config detail, edit, and history page layouts with larger content areas and full-screen reading.
- #15720 Automatically publish the first uploaded Skill version.
- #15746 Add operator-controlled outbound access policies for MCP tool imports.
- #15838 Clarify that rolling back the first inserted Config history record deletes the configuration.
- #15854 Remove untagged legacy Raft request parsing and preserve explicit errors for malformed log entries.
- #11122 Accept
healthCheckEnabledas a health-check switch entry while retaining the legacycheckalias. - #11890 Avoid removing metadata for instances that still exist after restart.
- #12557 Retry Config dump write-lock acquisition to prevent stale MD5 cache data.
- #14008 Fix native-image metadata required to establish gRPC client connections.
- #14804 Keep AI search available with partial results while indexes are being backfilled.
- #14981#15468 Fix concurrent Config publish duplicate-key handling through the datasource dialect SPI, including PostgreSQL
unique_violation. - #15410 Fix trailing separators when joining collections containing null elements.
- #15415 Prevent malformed config-plugin property names from discarding valid plugin configuration.
- #15420 Fix Skill ZIP uploads with invalid or unavailable version candidates.
- #15425 Prevent out-of-range batch indexes from causing
IndexOutOfBoundsException. - #15446 Fix page count calculation for empty and exactly divisible result sets.
- #15447 Prevent
NamingUtils.getServiceNamefrom failing on a trailing service separator. - #15466 Correct
@Sinceannotations for Skill upload APIs. - #15470 Prevent Naming connection cleanup from waiting for unrelated distributed-lock Raft writes.
- #15475 Fix standalone Console auth plugin initialization and forward the caller identity to downstream Server requests.
- #15476 Enforce Prompt visibility on list, detail, version, download, and Client read APIs.
- #15477 Wait for persistent service metadata before starting health checks.
- #15490 Fix Chinese text corruption in Skill Scanner pipeline reports on Windows.
- #15494 Restore complete MCP tool advanced-template support in Console UI Next.
- #15510 Reject explicitly supplied invalid Bearer tokens instead of falling back to anonymous access.
- #15534 Generate deterministic, ASCII-safe physical Config keys for AI resources.
- #15543 Restore case-sensitive collation for newly initialized MySQL Config schemas.
- #15557 Fix startup failures when plugin state snapshots are restored before unified plugin discovery.
- #15560 Preserve MCP tool passthrough authentication when editing and publishing runtime templates.
- #15603 Fix visibility query conversion when explicitly authorized resources are present.
- #15618 Try lower-priority explicit Skill upload versions before generating a version.
- #15620 Allow AI resource versions to be resubmitted after completed or stale review results.
- #15625 Fix gray Config cache null access and cross-thread visibility in Config disk services and client connections.
- #15634 Fix API authorization metadata, custom resource parser precedence, AgentSpec authorization, and Prometheus security path matching.
- #15642 Make AI resource deletion cleanup-first and retryable across all stored versions.
- #15658 Keep AI resource reads, updates, and deletion bound to the persisted storage provider.
- #15660 Fix standalone Console startup when the Config clone source-permission checker is unavailable.
- #15663 Preserve case-sensitive AI resource identities in MySQL search and task tables.
- #15675 Preserve nullable MCP tool output schemas during editing, display, and OpenAPI import.
- #15682 Prevent login responses from disclosing whether a username exists.
- #15689 Preserve string serialization of Config storage IDs with Jackson 3 to avoid numeric precision loss.
- #15701 Fix Config history next-record queries on Derby and preserve gray-version filtering.
- #15703 Migrate the legacy skills.sh importer state key without overriding canonical configuration.
- #15705 Clean removed Skill and AgentSpec draft files while retaining retry metadata after storage failures.
- #15710 Declare the required SQL LIKE escape clause for Derby, Oracle, and other affected dialects.
- #15712#15827 Reject unsafe instance addresses, HTTP targets, headers, and MySQL connection options in active health checks.
- #15714 Handle encoded context paths consistently in the legacy controller-method resolver.
- #15718 Escape all LIKE predicates when searching embedded roles with username filters.
- #15724 Forward the namespace when querying Config listeners by IP across cluster members.
- #15744 Align bootstrap and distribution configuration defaults.
- #15763 Reject invalid IPv6 mixed addresses with too many explicit address blocks.
- #15803 Reject unsafe AgentSpec and Skill ZIP layouts and enforce entry-count and decompression limits.
- #15804 Reject unsafe filesystem paths before Config, archive, and local rule-storage operations.
- #15821 Increase the embedded Derby connection timeout to prevent initialization failures on slow storage.
- #15844 Use the correct default gRPC protocol negotiator type.
- #15847 Restore public defaults for newly created Agent and MCP resources and preserve existing visibility scopes.
- #15850#15851 Select the default JDBC driver from the datasource dialect and clarify non-MySQL configuration examples.
- #15853 Return schema metadata in current, historical, and previous-version Config details.
- #15864 Resolve HEAD requests through their GET mapping in the legacy controller-method cache.
- #15866 Remove server-list event subscriptions on client shutdown and prevent callbacks from accessing a closed server-list provider.
- #14944 Upgrade Spring Boot from 3.5.14 to 4.0.6.
- #15470 Upgrade SOFA JRaft to 1.4.1 while preserving callback cache behavior and JRaft authentication.
- #15584 Upgrade Maven Compiler Plugin from 3.5.1 to 3.15.0 for JDK 25 build compatibility.
- #15645#15834 Upgrade compatible legacy and next Console dependencies, patch the sanitizer bundled with Monaco, and refresh packaged frontend assets.
- #15707 Upgrade Log4j API from 2.25.4 to 2.25.5.
- #15767 Upgrade gRPC to 1.81.0 to address CVE-2026-33871.
Nacos 3.3.0-RC changes authentication defaults, disables selected deprecated APIs, and introduces migration and compatibility boundaries that require attention before upgrading.
Affected users:
- Applications that connect without credentials and rely on the previous Client API authentication default.
- Integrations using deprecated Pipeline or Console MCP import endpoints.
- Deployments with legacy Config data, unsafe historical AI Config keys, or untagged Raft logs.
- Clusters migrating historical A2A or MCP resources, or planning a downgrade after migration or JRaft authentication enforcement.
- Applications relying on built-in Prometheus client metrics, private-network MCP tool imports, or implicit Agent/MCP visibility defaults.
Recommended upgrade path:
- Prepare Client API credentials. An absent
nacos.core.auth.enablednow meanstrue. Existing explicitfalsesettings remain effective. If credentials are not ready, explicitly retainfalseduring migration, provision identities and permissions, verify client access, and then enable authentication consistently on every member. Admin and Console authentication defaults are unchanged. - Migrate deprecated AI API calls. The deprecated Pipeline base-path list and path-variable detail endpoints, and the old Console MCP import endpoints, return HTTP
410withAPI_DEPRECATEDby default. Use Pipeline/listand/detailendpoints and the unified/v3/console/ai/import/validateand/executeendpoints.nacos.core.api.compatibility.enabled=truetemporarily reopens the selected endpoints; the oldnacos.ai.resource.import.legacy-mcp-api-enabledproperty is no longer recognized. - Complete legacy Config migrations. Upgrade pre-3.0 deployments through an earlier Nacos 3.x version. Migrate default-namespace data from the empty tenant to
public, and legacy beta/tag data fromconfig_info_betaandconfig_info_tagtoconfig_info_gray. For thenacos_configAI storage provider, explicitly migrate affected historical non-ASCII or overlength Config coordinates to the deterministic ASCII-safe mapping. - Check persisted Raft logs. Nacos 3.3 no longer replays untagged entries, including entries originally written by Nacos 2.0.x and retained across intermediate upgrades. Complete recovery and snapshot/log migration with a version that can read those entries before upgrading. Changing the running version alone does not convert persisted logs.
- Plan historical A2A migration explicitly. The default
nacos.ai.a2a.compatibility.mode=CANONICALdoes not scan historical data. For historical 3.0–3.2 A2A data, follow the migration runbook and configure new members withAUTOand a consistent migration policy. Early 3.3AUTOdeployments require the runbook's separate preflight. After permanent canonical cutover, a legacy-only server must not rejoin. MCP reconciliation also has a one-way managed-lifecycle transition; preserve its migration state and existing Config/Naming serving data. - Keep cluster server identities consistent. Native JRaft authentication becomes enforced once all members advertise support, and enforcement persists across restarts. A rolling downgrade to members without JRaft credential support is not guaranteed to remain available.
- Install a client metrics provider when needed. The mandatory Prometheus dependency has been removed from
nacos-client. Without an implementation ofNacosClientMetricsProvider, client metrics recording is a no-op, even whenenableClientMetricsis enabled. - Review MCP import access policy. Public MCP import targets remain available by default. Private or local targets must be explicitly allowed with
nacos.console.ai.mcp.import.allowed-private-addresses; HTTP redirects are not followed. - Set private resource scopes explicitly. The built-in visibility plugin defaults new Agent and MCP resources to
PUBLIC. Existing stored scopes and Prompt/Skill defaults are unchanged. Set the intended private scope for resources that should not be discoverable by other users. - Back up and rehearse the upgrade. Back up the database and relevant persisted data, then verify authentication, historical resource migration, discovery, and client behavior in staging before upgrading to Nacos 3.3.0-RC.
Deployments without the affected historical data do not require the data migrations above; the new authentication defaults and applicable API changes still need review.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 17 |
| Nacos-Client | Java 8 |
| Nacos-Maintainer-Client | Java 8 |
- @Ayanami-Shinji made their first contribution in https://github.com/alibaba/nacos/pull/15286
- @Zhengcy05 made their first contribution in https://github.com/alibaba/nacos/pull/15318
- @a981008 made their first contribution in https://github.com/alibaba/nacos/pull/15280
- @thegoldenflow made their first contribution in https://github.com/alibaba/nacos/pull/15348
- @hutiefang76 made their first contribution in https://github.com/alibaba/nacos/pull/15413
- @vasiliy-mikhailov made their first contribution in https://github.com/alibaba/nacos/pull/15415
- @Funzhou000 made their first contribution in https://github.com/alibaba/nacos/pull/15448
- @cl421866707 made their first contribution in https://github.com/alibaba/nacos/pull/15491
- @sweat123 made their first contribution in https://github.com/alibaba/nacos/pull/15502
- @fudianchn made their first contribution in https://github.com/alibaba/nacos/pull/15646
- @cyforkk made their first contribution in https://github.com/alibaba/nacos/pull/15631
- @GerardGao made their first contribution in https://github.com/alibaba/nacos/pull/15764
- @lavyoung made their first contribution in https://github.com/alibaba/nacos/pull/15771
- @neoLsH made their first contribution in https://github.com/alibaba/nacos/pull/15792
- @TianHengZhuang made their first contribution in https://github.com/alibaba/nacos/pull/15822
- @ABin-Huang made their first contribution in https://github.com/alibaba/nacos/pull/15817
- @Ashfaqbs made their first contribution in https://github.com/alibaba/nacos/pull/15849
Full Changelog: https://github.com/alibaba/nacos/compare/3.2.2...3.3.0-RC
3.2.4 (Aug 27th, 2026)
Nacos 3.2.4 is mainly a bugfix, security-hardening, and experience-improvement release for the 3.2 series.
This release focuses on:
- Strengthening JRaft, HTTP/gRPC authorization, embedded database, login, active health check, and MCP import security.
- Fixing standalone Console, Prompt visibility, Config history, listener state, and MCP tool authentication issues.
- Improving Config detail, edit, and history page usability.
For cluster and API operators, this release also:
- Adds server-identity authentication to native JRaft gRPC traffic with rolling-upgrade-aware enforcement.
- Disables selected deprecated v3 AI APIs by default and provides a temporary compatibility switch.
- Adds an allowlist policy for MCP tool imports from private or local targets.
Detailed changes in this release:
- #15687 Add server-identity authentication to native JRaft gRPC traffic with rolling-upgrade-aware enforcement.
- #14817 Add a shared, disabled-by-default compatibility gate for deprecated Pipeline and MCP import APIs.
- #15661 Harden distributed embedded database result resolution to supported scalar types and registered row mappers.
- #15688 Refactor controller context-path URI parsing for consistent route matching.
- #15695 Improve Config detail, edit, and history layouts with compact metadata and a full-screen content view.
- #15712 Harden active health checks by validating target addresses and disabling unsafe MySQL JDBC options.
- #15749 Add configurable outbound access control for MCP tool imports, allowing public targets and allowlisted private or local targets.
- #15475 Fix caller identity forwarding from a standalone Console so the Server enforces caller-specific RBAC.
- #15476 Fix Prompt visibility enforcement for list, detail, version, download, and Client read paths.
- #15560 Fix MCP tool passthrough authentication being lost after publishing from the Console.
- #15634 #15563 Fix authorization metadata and resource parsing across Admin, HTTP/gRPC, Prometheus, and AgentSpec APIs.
- #15660 Fix standalone Console startup failure caused by a missing Config clone permission checker bean.
- #15682 Prevent username enumeration by normalizing login failure responses.
- #15701 Fix Config history next-record queries on Derby and apply gray-name filtering correctly.
- #15724 Preserve the namespace filter when aggregating listener-by-IP state across cluster members.
Nacos 3.2.4 changes the default behavior of deprecated AI APIs and private MCP tool imports, and introduces an irreversible JRaft authentication enforcement transition.
Affected users:
- Users calling the deprecated Pipeline list/detail or legacy MCP import APIs. These APIs now return HTTP
410 Goneby default. - Console operators importing MCP tools from private or local addresses. These targets now require an administrator-managed allowlist.
- Clusters attempting a mixed-version rolling downgrade after all members have enabled JRaft authentication enforcement.
Recommended upgrade path:
- Migrate to the canonical Pipeline and
/v3/console/ai/import/*APIs. If additional migration time is required, temporarily setnacos.core.api.compatibility.enabled=true. - Configure
nacos.console.ai.mcp.import.allowed-private-addresseson every Console instance and restart the Console when private targets are required. - Before upgrading, verify that
nacos.core.auth.server.identity.keyandnacos.core.auth.server.identity.valueare configured identically on every cluster member. Nacos uses these values to authenticate JRaft gRPC requests but does not synchronize them across the cluster. - Do not rely on a mixed-version rolling downgrade after JRaft authentication has entered enforced mode.
Users already using the canonical AI APIs, public MCP endpoints, and consistent server identities are not affected by these compatibility changes.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 17 |
| Nacos-Client | Java 8 |
| Nacos-Maintainer-Client | Java 8 |
Full Changelog: https://github.com/alibaba/nacos/compare/3.2.3...3.2.4
2.5.4 (Aug 27th, 2026)
Nacos 2.5.4 is mainly a bugfix, security for the 2.x series.
Detailed changes in this release:
[#15661] Harden distributed database query result resolution. [#15712] Fix active health check target address validation.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 8 |
| Nacos-Client | Java 8 |
Full Changelog: https://github.com/alibaba/nacos/compare/2.5.3...2.5.4
3.3.0-BETA(Aug 6th, 2026)
Nacos 3.3.0-BETA is a feature iteration release for the Nacos 3.x series.
This release focuses on:
- Protocol-neutral Agent registration, management, and discovery.
- Agentic Resource Discovery for AI Registry resources.
- Dynamic plugin configuration and management.
- Distributed lock capabilities.
- Spring Boot 4 and Jackson 3 compatibility.
The main feature updates include:
- Agent lifecycle management, endpoint discovery, SDKs, Console support, and legacy A2A compatibility.
- Hybrid keyword and vector discovery for Skill, Prompt, and MCP resources.
- Runtime plugin configuration and AI resource visibility authorization.
- Phase 1 distributed reentrant and non-reentrant locks.
It also includes Skill workflow improvements, security hardening, compatibility fixes, performance optimizations, and dependency updates.
Detailed changes in this release:
- [#14466] Add a neutral JSON adapter with Jackson 2 and Jackson 3 runtime support.
- [#14804] Add protocol-neutral Agent registration, persistence, endpoint discovery, Java SDKs, Admin and Console APIs, Console management, and legacy A2A compatibility routing.
- [#15279] Add distributed reentrant and non-reentrant locks with watchdog renewal, FIFO waiting, gRPC notifications, Raft consistency, and a Java Lock SDK.
- [#15471] Support SkillSpector as an AI publish pipeline.
- [#15475] Add unified dynamic plugin configuration, lifecycle management, runtime updates, deterministic discovery, and Console configuration workflows.
- [#15476][#15604] Add plugin-owned visibility grant and revoke APIs and Console management for Skill and AgentSpec resources.
- [#15541] Add Agentic Resource Discovery with search, exploration, artifact retrieval, visibility filtering, persistent indexes, and hybrid keyword and vector retrieval.
- [#15640] Support Nacos server deployments on Linux RISC-V with RocksDB.
- [#12064] Support configuring the gRPC port offset through individual client properties.
- [#14932] Refactor the in-memory MCP cache to reduce read-path contention and improve index consistency.
- [#15315][#15561] Improve Skill upload precheck, conflict handling, and server-side ZIP validation.
- [#15322] Remove obsolete Config migration compatibility code and retain only the current Config storage model.
- [#15346] Manage the reserved
latestlabel for AI resources on the server. - [#15432][#15440][#15441] Remove reviewed unused Java code and preserve compatibility-facing contracts where required.
- [#15448] Improve English translations in Console UI Next.
- [#15486] Include the Skill owner in upload permission-denied messages.
- [#15606] Return a stable per-item result for every Skill batch upload candidate.
- [#12557] Add retry behavior when acquiring the Config dump write lock to prevent stale MD5 cache data.
- [#14981][#15468] Fix concurrent Config publish duplicate-key handling through the datasource dialect SPI, including PostgreSQL
unique_violation. - [#15410] Fix trailing separators when joining collections containing null elements.
- [#15415] Prevent malformed config-plugin property names from discarding valid plugin configuration.
- [#15420] Fix Skill ZIP uploads with invalid or unavailable version candidates.
- [#15425] Prevent out-of-range batch indexes from causing
IndexOutOfBoundsException. - [#15446] Fix page count calculation for empty and exactly divisible result sets.
- [#15447] Prevent
NamingUtils.getServiceNamefrom failing on a trailing service separator. - [#15466] Correct
@Sinceannotations for Skill upload APIs. - [#15490] Fix Chinese text corruption in Skill Scanner pipeline reports on Windows.
- [#15494] Restore complete MCP tool advanced-template support in Console UI Next.
- [#15510] Reject explicitly supplied invalid Bearer tokens instead of silently falling back to anonymous access.
- [#15534] Generate deterministic, ASCII-safe physical Config keys for AI resources.
- [#15543] Restore case-sensitive collation for newly initialized MySQL schemas.
- [#15557] Fix server startup failures when plugin state snapshots are restored before unified plugin discovery.
- [#15603] Fix visibility query conversion when explicitly authorized resources are present.
- [#15618] Fix Skill upload version resolution to try lower-priority explicit versions before generating a version.
- [#15620] Allow AI resource versions to be resubmitted after completed or stale review results.
- [#15634] Fix HTTP and gRPC authorization metadata, custom resource parser precedence, AgentSpec authorization, and Prometheus security path matching.
- [#14944] Upgrade Spring Boot from 3.5.14 to 4.0.6.
- [#15584] Upgrade Maven Compiler Plugin from 3.5.1 to 3.15.0 for JDK 25 build compatibility.
- [#15645] Upgrade compatible Console UI Next dependencies and regenerate packaged frontend assets.
Nacos 3.3 removes legacy Config migration compatibility paths and changes how unsafe AI resource Config keys are mapped.
Affected users:
- Users upgrading from a version earlier than Nacos 3.0 whose Config data uses the legacy empty tenant for the default namespace.
- Users with legacy beta or tag gray-release data in
config_info_betaorconfig_info_tag. - Users of the
nacos_configAI storage provider with historical non-ASCII or overlength resource identifiers.
Recommended upgrade path:
- Upgrade pre-3.0 deployments to an earlier Nacos 3.x version first.
- Migrate default-namespace data from the empty tenant to
public. - Migrate legacy beta and tag data to
config_info_gray. - Explicitly migrate affected AI resource Config coordinates to the new deterministic ASCII-safe mapping.
- Back up the database and verify the migration in a staging environment before upgrading to Nacos 3.3.0-BETA.
Users already running Nacos 3.x who do not have affected AI Config coordinates are not impacted by these migration removals.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 17 |
| Nacos-Client | Java 8 |
| Nacos-Maintainer-Client | Java 8 |
2.5.3 (Jul 14th, 2026)
Nacos 2.5.3 is mainly a bugfix, security, and experience-improvement release for the 2.x series.
This release focuses on:
- Compatible security dependency upgrades for the v2.x JDK 8 baseline.
- Client stability and logging improvements.
- Config namespace isolation fixes.
- Server-side request validation improvements.
It also keeps incompatible major dependency lines out of v2.x, such as Spring Boot 3, Spring Framework 6, and other JDK 17+ only upgrades.
Detailed changes in this release:
No major feature changes.
[#12323] Improve Logback packagingData behavior by making it configurable through nacos.logback.packagingData with default false, and upgrade the external Logback adapter to 1.1.5.
[#13940] Fix continuous class unloading during Nacos Client Log4j2 configuration reload by using safe Log4j2 initialization.
[#14423] Fix missing exceptions when form parameters exceed the configured Tomcat request size limit.
[#15437] Fix client shutdown thread leaks and executor creation race conditions in ConfigRpcTransportClient and related client components.
[#15497] Fix Config namespace isolation for ID-based export, batch delete, and clone operations, and enforce source namespace read permission for clone requests.
[#13998][#14859] Upgrade embedded Tomcat to 9.0.118 to address known Tomcat CVEs.
[#15025][#15451] Upgrade compatible v2.x dependencies, including Jackson to 2.18.9, gRPC Java to 1.75.0, and Spring Security to 5.8.16, while preserving the JDK 8 baseline.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 8 |
| Nacos-Client | Java 8 |
- @zmz789 made their first contribution in https://github.com/alibaba/nacos/pull/15288
Full Changelog: https://github.com/alibaba/nacos/compare/2.5.2...2.5.3
3.2.2 (Jul 14th, 2026)
Nacos 3.2.3 is mainly a bugfix and experience-improvement release for the 3.2 series.
This release focuses on:
- Improving AI Registry, Skill, MCP, and next console workflows.
- Fixing Config namespace isolation, Naming validation, and client stability issues.
- Improving observability and release dependency hygiene.
It also fixes bugs across Config, Naming, AI Registry, A2A, MCP, Client, Core, and Console.
Detailed changes in this release:
- #12737 #12867 Add per-Raft-group leader status and term metrics.
- #15321 Refresh client disk cache asynchronously after subscriber notifications.
- #15322 Align Logback adapter
packagingDataconfiguration. - #15354 Adjust next console sidebar menu elements.
- #15435 Improve AI resource version diff display in next console.
- #12585 Fix pagination parameter binding so
?placeholders work correctly. - #14036 Support HTTPS/TLS prefixes in HTTP login processing.
- #14693 Fix MCP service selector pagination in the console.
- #15032 Fix TCP health-check
SocketChannelleaks and exact member IP matching. - #15229 Normalize null A2A agent names in list queries.
- #15265 Allow Skill list fuzzy queries when
skillNamestarts or ends with a hyphen. - #15275 Copy
pg-upgrade-null-tenant-id.sqltodistribution/confto prevent PostgreSQL Docker upgrade startup failures. - #15296 Update service detail status after instance online/offline toggles.
- #15305 Reject blank instance IPs in Naming registration.
- #15350 Fix empty Config history compare content in next console.
- #15355 Restore editable Config clone target Data ID and group fields.
- #15359 Fix AI Registry version deletion corrupting version aggregates and breaking A2A/MCP queries.
- #15428 Preserve query parameters in MCP endpoint URLs after publish.
- #15430 Preserve
transportProtocolin auto-built MCP endpoint specs. - #15498 Scope ID-based Config export, batch delete, and clone operations by namespace.
- #15442 Roll up
console-ui-nextdependency fixes and rebuild next console static assets.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 17 |
| Nacos-Client | Java 8 |
| Nacos-Maintainer-Client | Java 8 |
Full Changelog: https://github.com/alibaba/nacos/compare/3.2.2...3.2.3
3.2.2 (May 29th, 2026)
Nacos 3.2.2 is mainly a bugfix and experience-improvement release for the 3.2 series.
This release focuses on:
- Console experience improvements for Config, Naming, MCP, Skill, AI resources, and namespace workflows.
- Stability and compatibility fixes across Config, Naming, plugins, startup scripts, and AI resource handling.
- AI Registry import, discovery, publishing, subscription, and security improvements.
For AI Registry and Console users, this release adds or improves:
- Importing AI resources from operator-configured external registries.
- Skill well-known discovery, Skill subscription, and latest protocol adapter support.
- Config diff confirmation, Prompt Markdown download, and Skill upload lifecycle improvements.
It also fixes bugs across Config, Naming, Console, MCP, Skill, plugins, and client-side watch handling.
Detailed changes in this release:
[#14695] Support label-based matching for Config gray rules. [#14848] Add Prompt version download as Markdown. [#14907] Support specifying a target version when uploading Skills. [#14985] Add persistent instance deregistration support in Console v3. [#15022] Support optional Skill auto-publish after review. [#15031] Extend nacos.functionMode with microservice and ai modes. [#15142] Support drag-and-drop ZIP upload and batch Skill upload. [#15183] Support importing AI resources from operator-configured external registries, including MCP resources, Skill well-known resources, importer APIs, SPI models, built-in presets, and source-based import UI. [#15234] Support commit messages when uploading AI skills. [#15247] Support the latest Skill well-known protocol in the registry adapter. [#15263] Add Skill subscription support and refactor AgentSpec subscription to HTTP polling with 304 handling.
[#14833][#15221] Route AI resource version trace logging through trace events and the default plugin. [#14911] Split LDAP authentication into an optional plugin and package the LDAP plugin JAR. [#14983] Enforce non-frontmatter Markdown body content during Skill validation. [#15059] Add the reviewed version status after pipeline approval for Skill versions. [#15066] Harden AgentSpec ZIP parsing with Zip Slip, Zip Bomb, and entry-count defenses. [#15138] Add Config publish diff confirmation in the new Console. [#15145] Restrict forcePublish to valid Skill states and add pipeline stale flags for re-edit. [#15164] Make Skill ZIP entry and size limits configurable. [#15165] Parallelize AgentSpec storage writes to align with Skill behavior. [#15258] Enable reviewed status by default for the AI publish pipeline.
[#11122] Accept healthCheckEnabled as a Naming switch-entry alias. [#14774] Shade Caffeine into the OIDC plugin JAR to avoid NoClassDefFoundError. [#14882] Fix Console theme color loss by adding RGB fallbacks. [#14952] Fix the incorrect MCP protocol value when the restToMcp switch is off. [#14992] Add v3 Naming APIs to DistroFilter to fix client API instance registration and deregistration in clusters. [#14997] Preserve SKILL.md indentation and validate Skill versions during upload and download. [#15000] Add the missing group_id LIKE placeholder in BaseConfigInfoMapper. [#15004] Replace deprecated AccessControlException usage with SecurityException. [#15037] Fix access denied errors on Console history detail, rollback, and compare pages. [#15067] Fix the missing write lock in MemoryMcpCacheIndex#removeIndex. [#15073] Preserve multi-byte UTF-8 characters across DiskUtils chunk boundaries. [#15136] Fix the password modification dialog display. [#15141] Fix namespace description editing when namespaceId is missing. [#15150] Prevent PostgreSQL tenant nulls from causing config sync row explosions. [#15152] Fix Config page display mismatches after namespace switching. [#15160] Fix ConfigChangeAspect misclassifying Console config changes as RPC when srcType is missing. [#15162] Default unlisted AI resources to base64 to avoid UTF-8 corruption. [#15167] Fix Console controller mapping with request context paths. [#15171] Re-exec startup scripts under bash when invoked through sh. [#15192] Reject submit requests for non-draft AI resource versions to protect formal version status. [#15201] Fix Skill description inconsistencies between list and detail after uploading a new version. [#15207] Fix MCP Console editor regressions for object-type tool input fields. [#15228] Guard fuzzy-watch futures against lost and spurious wakeups. [#15240] Fix Skill install card overflow with long Skill names in Console next. [#15252] Preserve namespace context on Console AI resource pages.
[#15039] Upgrade the PostgreSQL JDBC driver from 42.7.2 to 42.7.11. [#15060] Upgrade Micrometer to 1.15.10 to fix the Prometheus endpoint. [#15087] Upgrade vulnerable dependencies reported for the Nacos server image and enable default AI importers. [#15148] Add a console-ui-next npm min-release-age policy for supply-chain security.
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 17 |
| Nacos-Client | Java 8 |
| Nacos-Maintainer-Client | Java 8 |
- @Wyhhhh24 made their first contribution in https://github.com/alibaba/nacos/pull/14971
- @zy84338719 made their first contribution in https://github.com/alibaba/nacos/pull/15060
- @grllll made their first contribution in https://github.com/alibaba/nacos/pull/15057
- @ViperThanks made their first contribution in https://github.com/alibaba/nacos/pull/15110
- @jay666mnj made their first contribution in https://github.com/alibaba/nacos/pull/15178
- @wansho made their first contribution in https://github.com/alibaba/nacos/pull/15167
- @Hccake made their first contribution in https://github.com/alibaba/nacos/pull/15161
- @elnafateh made their first contribution in https://github.com/alibaba/nacos/pull/15118
- @Jholly2008 made their first contribution in https://github.com/alibaba/nacos/pull/15204
- @wushiyuanmaimob made their first contribution in https://github.com/alibaba/nacos/pull/15226
Full Changelog: https://github.com/alibaba/nacos/compare/3.2.1...3.2.2
3.2.1 (Apr 23th, 2026)
Nacos 3.2.1 is a patch release focused on critical bug fixes and feature enhancements for issues discovered in 3.2.0. This release delivers significant improvements to AI Registry functionality, database compatibility, security, and console user experience.
Key highlights include:
- AI Registry Maturity: Complete Prompt lifecycle management with UI, A2A AgentCard v1 protocol support, skill bizTag filtering, and resource spec storage for MCP servers
- Security Enhancements: Fixed LDAP authentication bypass vulnerability, added OIDC/OAuth2 SSO login support for both consoles
- Database Compatibility: Comprehensive PostgreSQL, Oracle, MySQL, and Derby fixes including deterministic pagination and schema timestamp issues
- Dependency Upgrades: Spring Boot 3.5.13, MCP SDK 0.17.0, and log4j-core 2.25.4
- Concurrency & Reliability: Eliminated race conditions in AI publish pipeline, naming module, client failover, and config export operations
- Console UX: Fixed configuration editing errors, namespace ID validation, batch import, token expiry handling, and UI bugs in both legacy and next consoles
- [#14621] A2A Registry 1.0 adapter with unified and normalized supported interfaces in agent card handling
- [#14796] Add MCP server resource specification support
- [#14807] Add Prompt lifecycle management UI for both legacy and next consoles
- [#14809] Enhance AI resource list APIs with filters and ordering support
- [#14847] Support AI resource subtype parsing in authentication plugin
- [#14895] Support filtering skills by bizTag in list API and console UI
- [#14794] Support force-publish skills for admin user
- [#14743] Close CallableStatement in DerbySnapshotOperation to prevent JDBC resource leak
- [#14750] Fix check-then-act race condition in FailoverReactor.isFailoverSwitch
- [#14751] Fix check-then-act race conditions on ConcurrentHashMap in naming module
- [#14784] Validate input parameters in ops controller forms for better security
- [#14806] Improve cluster metrics aggregation completeness signal in v3 API
- [#14818] Improve cluster metrics aggregation completeness signal in v3 API
- [#14822] Extract duplicated logic from SkillOperationServiceImpl and AgentSpecOperationServiceImpl into AiResourceManager and VersionUtils
- [#14834] Upgrade UI dependencies for both legacy and next consoles
- [#14873] Add config option to enable or disable visibility plugin
- [#14883] Add default scope resolution for new resource creation in visibility plugin
- [#14884] Standardize pipeline API and fix legacy console UI bugs
- [#14893] Add copilot feature toggle and redesign plugin management layout
- [#14927] Fix TOCTOU race condition and thread leak in ClientWorker.ensureSyncExecutor()
- [#14928] Fix TOCTOU race condition in removeSubscriberIndexes causing data loss
- [#14046] Fix ConfigInfoMapperByMySql.findConfigInfoLike4PageFetchRows result accuracy on MySQL
- [#14741] Add ORDER BY to findConfigInfoLike4PageFetchRows for deterministic pagination
- [#14742] Add ORDER BY to findConfigInfo4PageFetchRows for deterministic pagination
- [#14746] Add ORDER BY to remaining MySQL pagination queries for deterministic results
- [#14747] Add ORDER BY to Oracle pagination queries for deterministic results
- [#14748] Add ORDER BY to Derby pagination queries for deterministic results
- [#14764] Fix namespace ID validation issue in new UI when adding custom namespace
- [#14765] Fix configuration file editing error in 3.2 console
- [#14768] Fix
/v3/console/ai/mcp/importToolsFromMcpfailure due to json-schema-validator dependency conflict - [#14771] Fix batch import failure in legacy console UI
- [#14775] Add missing OIDC-related configurations to application.properties template
- [#14778] Fix clusterName forced to DEFAULT in v3 HTTP API
- [#14783] Remove downloadSkillZip from AiClientProxy interface and route skill download directly to HTTP client
- [#14786] Eliminate race condition in AI publish pipeline by pre-generating executionId
- [#14810] Fix PostgreSQL schema default timestamp issues causing startup failures
- [#14812] Set default timestamps to current time in Oracle and PostgreSQL schemas
- [#14828] Fix cross-type version contamination when querying ai_resource_version by name
- [#14832] Fix PostgreSQL compatibility issues for AI resource persistence and capacity modules
- [#14836] Fix cross-type version contamination in ai_resource_version queries
- [#14837] Enforce type isolation for ai_resource_version queries
- [#14843] Fix ActionTypes.WRITE to ActionTypes.READ for getting instance detail in InstanceControllerV3
- [#14849] Fix instance detail permission check in InstanceControllerV3
- [#14852] Fix prompt bizTags handling in both legacy and next UIs
- [#14853] Fix login page loop and header when auth is disabled in next console
- [#14856] Redirect to login page on token invalid/expired responses
- [#14862] Fix LDAP authentication bypass via hardcoded credentials in proxy user synchronization
- [#14875] Fix misleading error messages in maintainer-client ParamUtil
- [#14886] Fix legacy console UI bugs and improve robustness
- [#14892] Fix misleading value reporting in maintainer-client when timeout/retry properties are invalid
- [#14908] Fix skill content loss in SkillRemoteHandler#createDraft when passing skillCard as targetVersion
- [#14910] Add null check for optional ids parameter in exportConfigV2
- [#14915] Add null check for metaDataItem in config import
- [#14917] Reject login with LDAP-prefixed usernames to prevent auth bypass
- [#14947] Fix exception when adding Prompt page in console
- [#14782] Upgrade MCP SDK to 0.17.0 to resolve json-schema-validator conflict
- [#14834] Upgrade UI dependencies (both legacy and next consoles)
- [#14910] Bump org.apache.logging.log4j:log4j-core from 2.25.3 to 2.25.4
- [#14955] Upgrade Spring Boot from 3.4.10 to 3.5.13
Action Required: This release includes critical fixes for PostgreSQL, Oracle, MySQL, and Derby schemas, particularly around default timestamp values and ORDER BY clauses for deterministic pagination.
Before upgrading:
- Backup your existing database
- Apply the updated schema script:
conf/schema.sql(for your database type) - Restart Nacos server after schema migration
Affected databases:
- PostgreSQL: Default timestamp fixes, AI resource persistence compatibility
- Oracle: Default timestamp fixes
- MySQL: Pagination query accuracy improvements
- Derby: ORDER BY clause additions, JDBC resource leak fixes
Failure to apply schema changes may result in:
- Database startup failures (PostgreSQL)
- Inconsistent pagination results
- JDBC resource leaks
- AI resource version contamination
This release adds OIDC/OAuth2 SSO login support for both legacy and next consoles. To enable:
# OIDC Configuration
nacos.auth.oidc.enabled=true
nacos.auth.oidc.issuer-uri=<your-oidc-issuer-uri>
nacos.auth.oidc.client-id=<your-client-id>
nacos.auth.oidc.client-secret=<your-client-secret>
nacos.auth.oidc.redirect-uri=${domain}/v3/console/login
| Module | Java Required |
|---|---|
| Nacos-Server / Nacos-Console | Java 17 |
| Nacos-Client | Java 8 |
| Nacos-Maintainer-Client | Java 8 |
- AgentCard v1 Protocol: Full support for A2A AgentCard v1 protocol with extended capabilities
- Unified Interfaces: Normalized and validated supported interfaces in agent card handling
- Version Meta API: New API to query agent spec metadata without loading full content
- @CHEN666333-SVG made their first contribution in https://github.com/alibaba/nacos/pull/14818
- @Sunwenzhi58 made their first contribution in https://github.com/alibaba/nacos/pull/14866
- @LiyunZhang10 made their first contribution in https://github.com/alibaba/nacos/pull/14928
- @FatOnionLee made their first contribution in https://github.com/alibaba/nacos/pull/14946
Full Changelog: https://github.com/alibaba/nacos/compare/3.2.0...3.2.1