Risk Notice Regarding the Use of Older RocketMQ Spring Versions
Jun 18, 2026
ApsaraMQ for RocketMQDuring a recent inspection, we identified that the rocketmq-spring-boot versions used by some users contain a known community bug (apache/rocketmq-spring#365). This defect causes the client to return the send result prematurely, without properly waiting for the server's processing acknowledgment. In extreme scenarios such as server exceptions or downtime, this may lead to messages being skipped or failing to be consumed properly.
Scope of Impact
Affected versions: 2.0.0 to 2.2.1 (inclusive: 2.0.0, 2.0.1, 2.0.2, 2.0.3, 2.0.4, 2.1.0, 2.1.1, 2.2.0, 2.2.1)
Fixed versions: 2.2.2 and later. We recommend upgrading to the latest stable release, 2.3.x. For more details, please refer to the release notes.
Upgrade Recommendations & Benefits
After upgrading, the client will strictly adhere to the mechanism of "waiting for server acknowledgment before returning results," fundamentally eliminating the risk of message loss caused by this issue.
Compatibility Notes
This fix involves purely client-side dependency changes and does not require any server-side modifications. It is fully compatible with existing RocketMQ instances, ensuring a smooth and safe upgrade process.