[Bug] A malformed receipt handle is reported as INTERNAL_SERVER_ERROR, so official clients retry the ack forever

Đang mở
  • Có gì không ổn?
#11,375 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@iloveeyjafjalla đang làm issue này rồi.

Từ ngày 12/10/2026.

  • #11376 của @iloveeyjafjalla — đang mở

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
35/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
grpc, java
Lĩnh vực
backend-api-design

Hướng nghiên cứu

Read ReceiptHandle.decode, ResponseBuilder#buildStatus(Throwable), and the receipt handle call sites in AckMessageActivity, ChangeInvisibleDurationActivity, and ForwardMessageToDeadLetterQueue. Trace how parse errors become response statuses, then check the single and batch ack behavior. Done means malformed handles report INVALID_RECEIPT_HANDLE consistently and valid entries in a mixed batch can still be acknowledged.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Before Creating the Bug Report
  • I found a bug, not just asking a question, which should be created in GitHub Discussions.
  • I have searched the GitHub Issues and GitHub Discussions of this repository and believe that this is not a duplicate.
  • I have confirmed that this bug belongs to the current repository, not other repositories of RocketMQ.
Runtime platform environment

OS: any (proxy module, gRPC v2 consumer path)

RocketMQ version

branch: develop
Git commit id: 9ea2ccdc2b41445aee5e177e14e501d606f5a1ed (2026-10-08)

JDK Version

Compiler: Temurin 1.8.0_504 (target 1.8, same as CI)

Description

A receipt handle that cannot be parsed is reported as INTERNAL_SERVER_ERROR, not as INVALID_RECEIPT_HANDLE.

ReceiptHandle.decode throws IllegalArgumentException for a handle that does not parse (and NumberFormatException, also
an IllegalArgumentException, for non-numeric fields). In the gRPC v2 consumer path that exception reaches
ResponseBuilder#buildStatus(Throwable), which only maps ProxyException / GrpcProxyException, topic-not-found,
MQBrokerException, MQClientException, RemotingTimeoutException and the auth exceptions:

log.error("internal server error", t);
return buildStatus(Code.INTERNAL_SERVER_ERROR, ExceptionUtils.getErrorDetailMessage(t));

For an expired handle the code already reports the right thing — AbstractProcessor#validateReceiptHandle throws
ProxyException(ProxyExceptionCode.INVALID_RECEIPT_HANDLE) and the mapping table turns that into
Code.INVALID_RECEIPT_HANDLE — but a malformed handle takes the parse-error path instead. Concretely:

  • AckMessageActivity#processAckMessage catches the parse failure and completes the entry with
    INTERNAL_SERVER_ERROR;
  • AckMessageActivity#ackMessageInBatch decodes every entry before calling the processor, so one unparseable handle fails
    the whole batch request;
  • ChangeInvisibleDurationActivity and ForwardMessageToDeadLetterQueue decode the same way.

This matters to the official clients: rocketmq-clients ProcessQueueImpl#ackMessage gives up on a message only for
INVALID_RECEIPT_HANDLE ("forgive to retry") and otherwise calls ackMessageLater(...), retrying the ack every second
indefinitely. So a malformed handle produces an endless ack retry loop plus internal server error logs and server-error
alerts instead of a single, actionable client error — and in the batch case it also fails the valid entries of the same
request.

service.proto documents the expectation for AckMessage: "If the given receipt_handle is illegal or out of date, returns
INVALID_ARGUMENT", and definition.proto defines the dedicated INVALID_RECEIPT_HANDLE = 40013.

Steps to Reproduce
  1. Run a proxy and send AckMessage with receipt_handle = "not-a-receipt-handle" (one entry, or mixed with a valid entry
    in a batch).
  2. The entry/request status is INTERNAL_SERVER_ERROR instead of INVALID_RECEIPT_HANDLE; with enableBatchAck=true the
    whole request fails and the valid entries are not acknowledged either.
Expected behavior

An unparseable receipt handle is reported as INVALID_RECEIPT_HANDLE, exactly like an expired one, so clients drop the
message instead of retrying forever.

Actual behavior

INTERNAL_SERVER_ERROR (and, in the batch path, a request-scoped failure that hides the graded reason).

Additional context

Fix: decode receipt handles through a helper that turns the parse failure into
ProxyException(ProxyExceptionCode.INVALID_RECEIPT_HANDLE, …), and use it at the ack (single + batch),
change-invisible-time and forward-to-DLQ call sites.

Ngôn ngữ chính
Java
Star
22.7k
Fork
12k
Merge trung bình
4 ngày 20 giờ
Pull request đã merge (30 ngày)
11

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của apache/rocketmq

Tất cả issue của apache/rocketmq

Issue tương tự

Thêm issue về Java

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.