All Products
Search
Document Center

Simple Message Queue (formerly MNS):Java SDK release notes

Last Updated:Oct 09, 2026

This page lists changes to the Simple Message Queue (formerly MNS) Java SDK by version, including new features, bug fixes, and breaking changes. We recommend that you download the latest version of the SDK to ensure high performance and stability.

1.4.0

Released: 2025-08-04

Features

  • Improved the error message for BatchSendMessage when oversized message bodies are blocked.

  • Added the messageGroupId property to the message class for FIFO message support.

  • Topic message attributes now support the new versions of email and text message subscription clients.

Breaking changes

  • Minimum JDK version raised to JDK 8.

Download: GitHub Releases


1.3.1

Released: 2025-05-30

Bug fixes

  • Fixed a serialization parsing exception that occurred when consuming messages from a dead-letter queue (DLQ) in certain scenarios.

Download: GitHub Releases


1.3.0

Released: 2025-04-07

Features

  • Added user-defined attributes and system attributes to the message class.

Download: GitHub Releases


1.2.1

Released: 2025-04-02

Features

  • Changed the default socketTimeout value to 40 seconds.

  • Deprecated message count-related properties and methods in the QueueMeta class. Use CloudMonitor APIs to retrieve these metrics instead.

Bug fixes

  • Fixed a jaxb-runtime incompatibility in the JDK 8 runtime environment.

  • Fixed an issue where some requests timed out in extreme scenarios.

Download: GitHub Releases


1.2.0

Released: 2025-01-02

Dependencies

  • Upgraded aliyun-java-sdk-core to version 4.7.1.

Breaking changes

  • Receiving or deleting messages from a queue now requires explicit exception handling. Catch and handle exceptions to prevent uncaught exceptions from interrupting loop-based execution (such as a while loop).

Download: GitHub Releases


1.1.11

Released: 2024-08-23

Features

  • Improved the readability of the [Message]:null error message for invalid BatchDeleteMessage requests.

Download: GitHub Releases


1.1.10

Released: 2024-05-30

Features

  • AccessKey ID and AccessKey secret can now be loaded from environment variables. For more information, see Configure endpoints and credentials.

  • Queue-based and topic-based message production and consumption now support optional Base64 encoding and decoding.

  • Added sample code for the preceding features.

  • Added sample code for sending and consuming large files.

  • A RequestId is now returned when sending or publishing a message to simplify troubleshooting.

Bug fixes

  • Fixed a 500 error caused by the concurrent sample code in the official documentation.

  • Fixed an issue where retrieving a message from a queue still triggered a long wait even when waitseconds was set to 0.

  • Fixed a getCredentials inconsistency that caused request failures in extreme scenarios.

  • Fixed incorrect client version reporting that returned an old version or the SDK version of a different product.

Other changes

  • Sample code moved from the main directory to the test directory.

Download: GitHub Releases


1.1.9.1

Released: 2021-12-24

Dependencies

  • Replaced the Log4j dependency with SLF4J.

Download: aliyun-sdk-mns-1.1.9.1.jar


1.1.9

Released: 2021-03-18

Features

  • Added support for the OpenService API.

Bug fixes

  • Fixed the client throwing an I/O reactor status: STOPPED exception due to network jitter in certain scenarios.

Download: aliyun-sdk-mns-1.1.9.jar


1.1.8

Released: 2016-12-15

Features

  • Added a batch text message sending API for topic subscriptions.

Download: aliyun-sdk-mns-1.1.8.8.jar


1.1.7

Released: 2016-08-30

Features

  • The getMNSClient method now returns the same Java object across multiple calls.

  • Added a JSON format option for topic subscriptions.

Bug fixes

  • General bug fixes.

Download: aliyun-sdk-mns-1.1.7.1.jar


1.1.5

Released: 2016-05-26

Features

  • Added one-to-many message broadcasting.

  • Added sample code for Java SDK performance testing.

Download: aliyun-sdk-mns-1.1.5.jar


1.1.4

Released: 2016-04-25

Features

  • Queues and email addresses are now supported as subscription endpoints.

  • Added message filtering for topics.

Bug fixes

  • Fixed long polling request timeouts caused by the number of requests exceeding maxConnectionsPerRoute.

Download: aliyun-sdk-mns-1.1.4.jar


1.1.3

Released: 2016-03-28

Features

  • Added HTTPS support.

Breaking changes

  • Removed the default initial values of priority, dequeueCount, and delaySeconds in the Message object.

Download: aliyun-sdk-mns-1.1.3.jar


1.1.2

Released: 2016-01-30

Bug fixes

  • Fixed an issue where the waitseconds parameter for popMessage used the value from QueueMeta instead of 0 when no parameter was passed.

Download: aliyun-sdk-mns-1.1.2.jar


1.1.1

Released: 2016-01-19

Bug fixes

  • Fixed an issue where Chinese messages were encoded in UTF-8 instead of the platform's default character set.

Download: aliyun-sdk-mns-1.1.1.jar


1.1.0

Released: 2016-01-06

Features

  • Added topic support for publish/subscribe messaging.

  • Added Security Token Service (STS) token support.

  • Base64 encoding for messages is now optional.

Download: aliyun-sdk-mns-1.1.0.jar


1.0.5

Released: 2015-12-02

Bug fixes

  • Fixed a memory leak that occurred when multiple CloudAccount objects existed.

Dependencies

  • Upgraded httpasyncclient to version 4.1.

Download: aliyun-sdk-mns-1.0.5.jar


1.0.4

Released: 2015-11-05

Bug fixes

  • Fixed thread aborts in extreme cases of network abnormalities.

  • Fixed the resident thread that reclaims idle connections after they are closed.

Download: aliyun-sdk-mns-1.0.4.jar


1.0.3

Released: 2015-06-09

Features

  • Added support for BatchSendMessage, BatchReceiveMessage, BatchPeekMessage, and BatchDeleteMessage.

  • Added sample code.

Bug fixes

  • Fixed SDK hangs caused by too many connections in the CLOSE_WAIT state.

Other changes

  • Upgraded the API protocol version: x-mns-version=2015-06-06.

Download: aliyun-sdk-mns-1.0.3.jar


1.0.2

Released: 2015-03-03

Other changes

  • Optimized XML parsing logic for improved performance.

Download: aliyun-sdk-mqs-1.0.2.jar


1.0.1

Released: 2014-12-19

Other changes

  • Increased the default thread pool size to 50, resolving a performance bottleneck during high-concurrency synchronization.

Download: aliyun-sdk-mqs-1.0.1.jar