Nacos 3.1.2 is a patch release focused on stability improvements, security fixes, and AI module enhancements. Key highlights include:
- Security: Upgraded Spring Boot to 3.4.10 to address CVE-2025-55752, plus log4j and gRPC dependency updates
- AI/MCP: Fixed MCP cache inconsistency issues and added version parameter support for Agent Card queries
- Console: Improved distributed deployment experience with automatic server member sync and fixed multiple context path issues
- Client: Eliminated class unloading memory leak during config reload and fixed UUID passing issue in fuzzy listening
- Config: Enhanced config metadata publishing with audit logging and notifications
Feature
- [#13996] Add event publishing for agent and MCP endpoint operations
- [#13999] Add audit logging and notifications for config metadata publishing
- [#14120] Add version parameter support to Maintainer SDK Get Agent Card method
Enhancement/Refactor
- [#14000] Eliminate class unloading memory leak during configuration reload using Configuration.initialize()
- [#14062] Prevent potential data modification risk in client ServiceInfoHolder
- [#14099] Add validation for serviceName and groupName in SubscribeServiceRequestHandler
- [#14449] Remove ineffective ThreadLocal in MD5Utils
- [#14454] Throw proper exception when form parameters exceed size limit
BugFix
- [#13770] Fix missing context path in importToolsFromMcp and other AI-related APIs
- [#14009] Fix UUID passing issue in configuration fuzzy listening causing initialization events to be filtered
- [#14016] Fix Console automatic server member synchronization in distributed deployment
- [#14020] Fix missing '?' placeholder in database query
- [#14024] Fix MCP cache index inconsistency when recreating MCP server with same name
- [#14028] Fix remote server selection to use healthy nodes during import/export operations
- [#14063] Fix control plugin bug
- [#14104] Fix AI API context path errors in console
- [#14114] Fix incorrect grayRule detection in ConfigMigrateService
- [#14121] Fix console-ui pagination reset to 0 instead of 1 on API error
- [#14210] Fix MainLayout to handle language changes and fetch notices on update
- [#14401] Fix incorrect created field returned by ConfigRowMapperInjector
- [#14402] Fix MySQL LIKE query escaping to prevent underscore and hyphen confusion
- [#14442] Fix Derby and MySQL LIKE query with proper escape handling
- [#14450] Fix console remote server context-path for maintainer-client
- [#14635] Fix health status update method to correctly handle persistent instances
Dependencies
- [#14006] Upgrade Spring Boot to 3.4.10 to address CVE-2025-55752
- [#14055] Bump org.apache.logging.log4j:log4j-core from 2.24.3 to 2.25.3
- [#14714] Upgrade gRPC version to 1.78.0
Deployment Required
| Module | Java Required |
|---|---|
| Nacos-Server/Nacos-Console | Java 17 |
| Nacos-Client | Java 8 |
| Nacos-Maintainer-Client | Java 8 |
Contributors
Thanks to all contributors: @KomachiSion, @chunhai1127, @INotWant, @chlch, and the Nacos community.
Full Changelog: 3.1.1...3.1.2