Microservices Engine:Java agent versions

5.1.0 -- Official (June 12, 2026)

Bug fixes

• Fixed a bug in throttling protection where the number of throttling resources increased significantly during client-side throttling.

• Fixed a bug where applications failed to start in Spring WebFlux 6.x scenarios.

• Fixed a traffic loss issue during rolling updates after horizontal pod autoscaler (HPA) was enabled on a cluster, or during rolling updates that changed the number of replicas at the same time.

4.8.0 -- Official (April 29, 2026)

Bug fixes

• Fixed a traffic loss issue during RocketMQ client shutdown.

• Fixed a bug where metadata was lost during Eureka application registration, causing end-to-end canary release failures.

• Fixed a bug where end-to-end canary release tags were lost for RocketMQ producers.

4.7.1 -- Official (February 26, 2026)

New features

• Added throttling protection support for the Spring WebFlux framework.

• Added custom behavior support for system protection.

• Added support for external clusters to connect to and use MSE microservice administration.

Improvements

• Improved graceful start and shutdown performance in Spring Cloud Nacos and Eureka scenarios to further prevent traffic loss.

• Improved the reporting and display of the system CPU utilization metric.

Bug fixes

• Fixed a bug where preferred routing to the same availability zone did not work for Dubbo when simplified=true was enabled.

• Fixed a serialization error during delayed registration for Eureka clients.

• Fixed a java.version field parsing failure for system metrics in OpenJDK Alpine Docker images.

• Fixed a source parsing bug in throttling protection for Dubbo 3.x scenarios.

• Fixed a bug where end-to-end canary release did not work for Spring Cloud Alibaba 2023 and later.

• Fixed a memory leak during metadata reporting caused by network issues.

4.6.3 -- Official (December 15, 2025)

New features

• Added the Completed QPS metric to indicate the number of requests completed in the current time window.

• Added conditional registration for graceful start. For details, see conditional registration for graceful start.

• Added support for RetryableFeignBlockingLoadBalancerClient in passive notifications for graceful start and shutdown.

Improvements

• Improved graceful shutdown by making active notifications asynchronous and adding timeout detection.

4.5.2 -- Official (September 11, 2025)

Bug fixes

• Fixed a bug in throttling protection where total QPS and total concurrent requests were counted twice for the Zuul framework.

4.4.2 -- Official (September 9, 2025)

New features

• Added plug-in-free end-to-end canary release support for XXL-JOB in MSE task scheduling.

Improvements

• Improved the coordination between the readiness probe and delayed registration in Eureka scenarios for graceful start and shutdown.

• Improved the automatic detection mechanism for different Spring MVC versions in throttling protection.

Bug fixes

• Fixed a bug where context-path metadata acquisition failed for Spring Boot applications.

4.5.0 -- Not recommended (July 17, 2025)

New features (throttling protection)

• Added support for the RestTemplate framework.

• Added support for Apache HttpClient (4.x and 5.x).

• Added support for the OkHttp framework.

• Added a default namespace (default) configuration to throttling rules.

Bug fixes

• Fixed a bug where the regionId was missing in non-ACK environments when access to the Alibaba Cloud resource metadata API failed.

• Fixed a bug where AliyunJavaAgent for Nacos incorrectly read user AccessKey pair configurations.

• Fixed a bug where the git.properties file in the AliyunJavaAgent package overwrote user content.

Changes

• Removed unexpected rule pulling when the MSE authentication feature is disabled.

4.3.4 -- Not recommended (May 12, 2025)

New features

• Added support for XXL-JOB in end-to-end canary release.

• Added client-side filtering for RocketMQ gRPC 5.x in end-to-end canary release for messages.

Improvements

• Upgraded the throttling protection architecture to improve compatibility with open-source Sentinel and overall stability.

Bug fixes

• Fixed metric classification for the Zuul and Dubbo frameworks in throttling protection.

• Fixed a bug where canary release did not work for the Ribbon framework when Nacos rules were used.

• Fixed uneven traffic distribution for the Feign framework when round-robin was used in end-to-end canary release.

• Fixed a bug in manual offline that caused applications with duplicate IP addresses to become unavailable.

• Fixed a bug in manual offline that caused unexpected applications to go offline when multiple applications were deployed on the same ECS instance.

4.2.5 -- Official (April 10, 2025)

New features

• Added server-side filtering support for RocketMQ Remoting Client 5.1.0 and later in end-to-end canary release for messages.

Improvements

• Improved memory performance in throttling protection when throttling is frequently triggered.

Bug fixes

• Fixed a bug where active notifications did not work for graceful start and shutdown.

• Fixed a conversion bug in multi-tag filtering rules for RocketMQ 5 in end-to-end canary release for messages.

4.2.2 -- Official (January 9, 2025)

New features

• Added support for RocketMQ 5.0.4 and 5.0.7 in end-to-end canary release.

Bug fixes

• Fixed a bug where canary release did not work for the Dubbo framework (2.7.x and 3.x) when ZooKeeper was used as the registry.

• Fixed incorrect concurrent request statistics for throttling protection in asynchronous Spring MVC scenarios.

4.2.0 -- Not recommended (December 6, 2024)

New features

• Added an application shutdown event for graceful start and shutdown. For details, see Event Center event summary.

• Added instrumentation support for the Tomcat servlet framework in throttling protection. Disabled by default.

• Added default circuit breaking protection, total QPS/concurrency throttling protection, and system protection and exception item configurations. For details, see default circuit breaking protection settings.

• Added support for the Dubbo 3.x Triple protocol and application-level service discovery in end-to-end canary release.

Improvements

• Improved support for the Spring Boot 3 series in graceful start and shutdown.

• Improved the boundary logic for Spring Cloud LoadBalancer in end-to-end canary release.

• Improved the graceful shutdown process to resolve performance issues related to passive notifications.

Bug fixes

• Fixed an issue in end-to-end canary release for Spring Cloud applications that use Consul as the registry.

• Fixed a bug in microservice administration that prevented writing to the default log folder when permissions were missing.

4.1.10 -- Not recommended (September 5, 2024)

New features

• Added preferred routing to the same availability zone for Spring Cloud and Dubbo.

• Added support for ONS Client versions in end-to-end canary release for messages.

Bug fixes

• Fixed a bug where Dubbo consumer interfaces were not visible in MSE microservice administration.

• Fixed a bug in throttling protection that affected the Feign framework when a fallback was used.

Changes

• Disabled the MyBatis plugin for MSE throttling protection by default. To re-enable it, set the environment variable or startup parameter spring.cloud.ahas.sentinel.mybatis.enabled=true.

3.2.10 -- Official (July 11, 2024)

Bug fixes

• Fixed an issue where applications failed to start when the Spring Cloud Alibaba Sentinel framework was used.

4.1.9 -- Official (July 10, 2024)

New features

• Added support for RocketMQ 4.x Sync Pull in end-to-end canary release for messages.

• Added the ALIYUN_JAVA_AGENT_MINIMAL_MEMORY environment variable to specify the minimum startup memory size.

• Added graceful shutdown support for Dubbo 3.2.x and RocketMQ.

Bug fixes

• Fixed an issue where pulling Dubbo tag-based routing rules failed.

• Fixed a bug in microservice administration in SAE scenarios.

• Fixed a conflict between the agent and sentinel-spring-webmvc-6x-adapter.

Changes

• Introduced the :54199/readiness endpoint for readiness probes.

3.2.9 -- Official (March 28, 2024)

New features

• Added custom instrumentation for throttling protection in microservice administration. For details, see Add a custom interface in microservice administration.

• Added support for Spring Boot 3.0 through 3.2 in microservice administration.

• Added support for JDK 21 in microservice administration.

• Added support for Dubbo 3.x in microservice administration.

3.1.4 -- Official (December 25, 2023)

New features

• Added fault tolerance to end-to-end canary release: requests with an empty trace now route to the base environment instead of random environments.

Improvements

• Improved MSE logic performance.

• Migrated request parameter and request body parsing from Tomcat to the filter components of Zuul and Spring Cloud Gateway.

• Switched the data source for the CPU utilization metric in MSE Enterprise Edition to Sentinel.

Bug fixes

• Fixed an issue where changing Related from false to true caused the readiness probe to fail.

• Fixed an issue where delayed registration did not take effect for Eureka.

Changes

• Stopped collecting ARMS spans, metrics, and metadata when only the MSE feature is enabled.

3.0.7 -- Official (November 18, 2023)

New features (throttling protection)

• Added support for customizing the behavior of RPC calls.

• Added support for configuring SentinelWebInterceptor at the head of the processing chain for accurate throttling data.

• Added agent-based injection of SentinelWebInterceptor as a supplement when the starter injection mechanism fails.

Improvements

• Aligned WebInterceptor resource names with their default behavior so that interface names include the context-path prefix.

• Set the agent thread pool to static final to clarify thread pool ownership.

Bug fixes

• Fixed a conflict between the service authentication switch and other configuration items.

• Fixed an error in throttling protection when FeignClientBuilder used the forType method to build a FeignClient.

Changes

• Stopped the MSE logic from running when MSE is not enabled on the agent.

• Stopped reporting Microservice Insight data to the server side. The agent records data to local logs. Collect the logs independently.

2.9.2 -- Official (September 9, 2023)

New features (throttling protection)

• Added support for customizing the behavior of RPC calls.

• Added support for placing SentinelWebInterceptor at the head of the processing chain.

• Added agent-based injection of SentinelWebInterceptor as a supplement when the starter injection mechanism fails.

2.9.1.2 -- Official (August 3, 2023)

New features

• Added support for using alicloud_service_tag labels and annotations to tag nodes.

• Launched microservice administration in the China (Hangzhou) Finance Cloud region.

Bug fixes

• Fixed uneven traffic load for Spring Cloud Ribbon.

• Fixed a caching issue for GetLocalV4Ip.

• Fixed a bug where traffic requests failed when MSE Enterprise Edition was used with Spring Cloud Gateway and open-source SCA Sentinel.

• Fixed a bug in throttling protection that affected the Feign framework when only fallback was used.

• Fixed an issue where inconsistent timestamps in labels and annotations files caused continuous re-registration.

• Fixed an issue where asynchronous traces were occasionally lost in the Reactor framework.

Changes

• Stopped initializing MSE-related logic when MSE is not enabled.

2.9.0 -- Official (July 13, 2023)

New features

• Added throttling protection support for the Zuul and Spring Cloud Gateway frameworks.

• Added persistent service discovery for MSE.

• Added support for Dubbo 3.x in canary release and tag-based routing.

• Added support for matching end-to-end canary release rules based on the HTTP body.

Improvements

• Improved graceful start and shutdown performance for MSE.

2.8.3 -- Official (March 31, 2023)

New features

• Added support for JDK 11 and JDK 17.

• Added namespace-based access to isolate environments such as development, testing, and production in MSE.

• Added throttling protection for MSE.

• Added support for Consul as the registry in MSE microservice administration.

• Added support for Consul and Undertow in end-to-end canary release.

• Launched Microservice Insight, which provides observability for graceful start and shutdown and for end-to-end canary release.

2.7.3.5 -- Official (July 27, 2022)

New features

• Added end-to-end canary release for RocketMQ messages.

• Added tagging support in the OpenSergo registry and in canary release on MSE cloud-native gateways.