All Products
Search
Document Center

ApsaraMQ for RocketMQ:Release notes for RocketMQ ONS 1.x SDK for Java

Last Updated:Mar 11, 2026

This topic lists the release date, changes, and download link for each version of the RocketMQ ONS 1.x SDK for Java.

Important
  • Java Development Kit (JDK) 1.8 is applicable to all versions of the TCP client SDK for Java. JDK 1.6 is applicable only to version 1.8.4.Final and earlier. To prevent compatibility issues when you upgrade, use JDK 1.8.

  • For Maven dependency setup, see Prepare the environment.

1.9.1.Final

Release date

Description

Download link

2024-07-15

Fixed issue

The version of Guava is updated to 32.1.2-jre, and the security vulnerability CVE-2023-2976 is fixed.

ons-client-1.9.1.Final

1.9.0.Final

Release date

Description

Download link

2024-04-10

Added feature

The namespace parameter is added. This allows you to access serverless ApsaraMQ for RocketMQ 5.0 instances over the Internet.

ons-client-1.9.0.Final

1.8.8.8.Final

Release date

Description

Download link

2023-02-06

Fixed issue

The modifiable configuration item clientCloseSocketIfTimeout is added to quickly close abnormal TCP connections.

ons-client-1.8.8.8.Final

1.8.8.7.Final

Release date

Description

Download link

2023-01-11

Fixed issues

  • Message traces are lost when multiple messages are consumed at a time.

  • Some messages fail to be consumed because the maximum wait time is not configured when multiple messages are consumed at a time.

ons-client-1.8.8.7.Final

1.8.8.5.Final

Release date

Description

Download link

2022-05-16

Bug fix:

  • Fixed an atomicity issue in the updateCredential operation that caused cross-account authorization for RAM roles using STS to fail when the operation was frequently called to update the AccessKey ID, AccessKey secret, and STS token. This fix applies only to RAM role authorization. The issue persists if you manually update the AccessKey ID, AccessKey secret, and STS token during authorization.

ons-client-1.8.8.5.Final

1.8.8.3.Final

Release date

Description

Download link

2022-01-18

Improvements:

  • Fixed an issue where a message at a specific consumer offset was skipped due to broker errors.

  • Fixed an incorrect time unit for the message consumption timeout period.

ons-client-1.8.8.3.Final

1.8.8.1.Final

Release date

Description

Download link

2021-08-24

Improvements:

  • Fixed an error that occurred when ordered messages were retried.

  • Fixed an issue where multiple duplicate messages were generated when the client retried sending a message that failed to be consumed in specific scenarios.

ons-client-1.8.8.1.Final

1.8.8.Final

Release date

Description

Download link

2021-04-02

Improvements:

  • Optimized heartbeat sending logic.

  • Reduced excessive SDK memory usage.

  • Fixed an issue where a message was sent back to the broker when the consumer failed to consume it.

  • Fixed an issue where the topic-specific message cache limit did not take effect.

ons-client-1.8.8.Final

1.8.7.4.Final

Release date

Description

Download link

2021-02-08

Improvements:

  • Fixed delayed consumption of ordered messages in specific scenarios.

  • Fixed an issue where ports were occupied for liveness detection on message producers.

ons-client-1.8.7.4.Final

Note

If you use version 1.8.7.1.Final or later to consume ordered messages, update the SDK client to the latest version.

1.8.4.Final

Release date

Description

Download link

2019-09-27

New features:

  • Added JDK 1.6 support.

  • Added asynchronous message retry support.

  • Added synchronous message retry support for scenarios where brokers are busy.

ons-client-1.8.4.Final

1.8.0.Final

Release date

Description

Download link

2019-02-21

Bug fix:

  • Fixed the automatic retry logic for synchronous message sending. A maximum of three retries is now enforced when a producer fails to send a message to a topic in a new instance.

ons-client-1.8.0.Final

1.7.8.Final

Release date

Description

Download link

2018-07-06

New feature:

  • Added dynamic renewal for STS tokens.

Bug fixes:

  • Reduced the default single log file size from 1 GB to 64 MB.

  • Fixed an issue where duplicate log files were generated.

ons-client-1.7.8.Final

Earlier versions

1.7.7.Final

Release date

Description

Download link

2018-04-25

Bug fix:

  • Fixed an issue where message traces could not be sent when multiple consumer or producer instances were initialized in the same process. This issue affects version 1.7.5.Final and version 1.7.6.Final. Update your SDK if you are affected.

ons-client-1.7.7.Final

1.7.6.Final

Release date

Description

Download link

2018-04-04

New feature:

  • Added support for all log frameworks.

Bug fixes:

  • Added Apache Log4j2 support.

  • Fixed an unexpected client shutdown when fetching name servers.

  • Updated FastJSON to 1.2.48.

ons-client-1.7.6.Final

1.7.5.Final

Release date

Description

Download link

2018-03-23

Bug fix:

  • Migrated to internal Alibaba Cloud dependencies.

ons-client-1.7.5.Final

1.7.4.Final

Release date

Description

Download link

2018-03-02

New features:

  • Added STS token-based access to Message Queue for Apache RocketMQ.

  • Added broker priority for message trace data, which is now sent preferentially to brokers of the current cluster.

Bug fix:

  • Fixed JDK 1.6 incompatibility.

ons-client-1.7.4.Final

1.7.2.Final

Release date

Description

Download link

2018-01-25

New features:

  • Added transport layer encryption for Enterprise Platinum Edition instances to improve data security when generating signatures with AccessKey ID and AccessKey secret.

  • Added SQL attribute filtering for Enterprise Platinum Edition consumers to improve subscription efficiency.

  • Added automatic name server change detection for high availability, O&M activities, and seamless switchovers.

  • Improved client version reporting to send accurate version information to the broker during connection.

ons-client-1.7.2.Final

1.7.1.Final

Release date

Description

Download link

2017-12-19

New features:

  • Added support for custom callback thread pools when sending messages asynchronously.

  • Added the JVM -D parameter Dclient.callback.executor.thread.nums to configure the number of threads in the public thread pool. For example, set this parameter to 10.

Bug fixes:

  • Fixed an issue where the cache count was not decreased when a message was sent back to the broker due to a consumption timeout.

  • Fixed premature release of the asynchronous semaphore on the client.

ons-client-1.7.1.Final

1.7.0.Final

Release date

Description

Download link

2017-10-23

New feature:

  • Updated the client message cache policy to support both message count and cache size dimensions.

Improvement:

  • Improved the ProducerName parameter in the built-in tracing module to allow different values per user.

Bug fixes:

  • Fixed an issue where a client trace thread prevented the client from exiting.

  • Fixed an issue where the message trace ShutDownHook was created multiple times.

ons-client-1.7.0.Final

1.6.1.Final

Release date

Description

Download link

2017-08-31

Improvements:

  • Added Java documentation for all client API operations.

  • Improved the client address retrieval method to eliminate the need to modify the hostname configuration in /etc/hosts.

ons-client-1.6.1.Final

1.6.0.Final

Release date

Description

Download link

2017-07-31

New features:

  • Shaded the client in the source code for correct debugging.

  • Exposed the BornHost and BornTimestamp message attributes on the client.

  • Added the BatchConsumer operation for batch message consumption.

  • Added a BatchConsumer demo for consuming multiple ordered messages with Spring.

Improvements:

  • Stored the sharding key in the message structure for partitionally ordered messages.

  • Added integer value support for message attribute settings.

ons-client-1.6.0.Final

What to do next

Prepare the environment