Skip to content

3.3.0-BETA(Aug 6th, 2026)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@KomachiSion KomachiSion released this 06 Aug 12:01
3.3.0-BETA
35790e5

Nacos 3.3.0-BETA

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:

Feature

  • [#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.

Enhancement/Refactor

  • [#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 latest label 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.

BugFix

  • [#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.getServiceName from failing on a trailing service separator.
  • [#15466] Correct @Since annotations 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.

Dependencies

  • [#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.

Breaking Change Notice

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_beta or config_info_tag.
  • Users of the nacos_config AI 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.

Java Version Requirements

Module Java Required
Nacos-Server / Nacos-Console Java 17
Nacos-Client Java 8
Nacos-Maintainer-Client Java 8
Assets 6
Loading