Skip to content
TheChatArchiveThe Chat Archive
Claudeclaude-sonnet-5· anthropicHugging Face ibragim-bad/swe_rebench_07_2026_trajectories

ISSUE DESCRIPTION [Bug] WebSocket ReaderHandler returns 500 for invalid messageId query…

  1. User

    ISSUE DESCRIPTION

    [Bug] WebSocket ReaderHandler returns 500 for invalid messageId query parameter

    Search before reporting

    • I searched in the issues and found nothing similar.

    Read release policy

    • I understand that unsupported versions don't get bug fixes. I will attempt to reproduce the issue on a supported version of Pulsar client and Pulsar broker.

    User environment

    Broker Version 4.0.7 Any broker OS Any broker Java version Any WebSocket client

    Issue Description

    Minimal reproduction steps

    Connect to the WebSocket reader endpoint with an invalid messageId query parameter.

    Two examples that both trigger the bug:

    1. An improperly URL-encoded base64 message ID that includes a + which the server interprets as a space (e.g. CJCj6QEQ+UQwAA== becomes CJCj6QEQ UQwAA==).

    2. An arbitrary non-base64 string: ?messageId=invalidMessageId

    What did you expect to see?

    HTTP 400 Bad Request.

    What did you see instead?

    HTTP 500 Internal Server Error in both cases.

    Case 1 — IllegalArgumentException from Base64.getDecoder().decode():

    WARN  org.apache.pulsar.websocket.ReaderHandler - [REDACTED] Failed in creating reader on topic persistent://REDACTED/REDACTED/REDACTED
    java.lang.IllegalArgumentException: Illegal base64 character 20
    	at java.base/java.util.Base64$Decoder.decode0(Unknown Source) ~[?:?]
    	at java.base/java.util.Base64$Decoder.decode(Unknown Source) ~[?:?]
    	at java.base/java.util.Base64$Decoder.decode(Unknown Source) ~[?:?]
    	at org.apache.pulsar.websocket.ReaderHandler.getMessageId(ReaderHandler.java:348) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.ReaderHandler.<init>(ReaderHandler.java:95) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.WebSocketReaderServlet.lambda$configure$0(WebSocketReaderServlet.java:44) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    

    Case 2 — IOException wrapping IndexOutOfBoundsException from MessageIdImpl.fromByteArray():

    WARN  org.apache.pulsar.websocket.ReaderHandler - [REDACTED] Failed in creating reader on topic persistent://REDACTED/REDACTED/REDACTED
    java.io.IOException: java.lang.IndexOutOfBoundsException: readerIndex(5) + length(641882) exceeds writerIndex(12): UnpooledHeapByteBuf(ridx: 5, widx: 12, cap: 12/12)
    	at org.apache.pulsar.client.impl.MessageIdImpl.fromByteArray(MessageIdImpl.java:93) ~[org.apache.pulsar-pulsar-client-original-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.ReaderHandler.getMessageId(ReaderHandler.java:348) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.ReaderHandler.<init>(ReaderHandler.java:95) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.WebSocketReaderServlet.lambda$configure$0(WebSocketReaderServlet.java:44) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    Caused by: java.lang.IndexOutOfBoundsException: readerIndex(5) + length(641882) exceeds writerIndex(12): UnpooledHeapByteBuf(ridx: 5, widx: 12, cap: 12/12)
    	at io.netty.buffer.AbstractByteBuf.checkReadableBytes0(AbstractByteBuf.java:1442) ~[io.netty-netty-buffer-4.1.127.Final.jar:4.1.127.Final]
    	at io.netty.buffer.AbstractByteBuf.checkReadableBytes(AbstractByteBuf.java:1428) ~[io.netty-netty-buffer-4.1.127.Final.jar:4.1.127.Final]
    	at io.netty.buffer.AbstractByteBuf.skipBytes(AbstractByteBuf.java:971) ~[io.netty-netty-buffer-4.1.127.Final.jar:4.1.127.Final]
    	at org.apache.pulsar.common.api.proto.LightProtoCodec.skipUnknownField(LightProtoCodec.java:264) ~[org.apache.pulsar-pulsar-common-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.common.api.proto.MessageIdData.parseFrom(MessageIdData.java:304) ~[org.apache.pulsar-pulsar-common-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.client.impl.MessageIdImpl.fromByteArray(MessageIdImpl.java:91) ~[org.apache.pulsar-pulsar-client-original-4.0.7.jar:4.0.7]
    

    Details

    ReaderHandler.getMessageId() performs no validation on the messageId query parameter before passing it to Base64.getDecoder().decode() and MessageIdImpl.fromByteArray().

    ReaderHandler's constructor catches Exception during setup but hardcodes HttpServletResponse.SC_INTERNAL_SERVER_ERROR in the error response. ConsumerHandler and ProducerHandler both call AbstractWebSocketHandler.getErrorCode(e) instead, which maps IllegalArgumentException to SC_BAD_REQUEST (400).

    Error messages

    **Case 1** — `IllegalArgumentException` from `Base64.getDecoder().decode()`:
    
    WARN  org.apache.pulsar.websocket.ReaderHandler - [REDACTED] Failed in creating reader on topic persistent://REDACTED/REDACTED/REDACTED
    java.lang.IllegalArgumentException: Illegal base64 character 20
    	at java.base/java.util.Base64$Decoder.decode0(Unknown Source) ~[?:?]
    	at java.base/java.util.Base64$Decoder.decode(Unknown Source) ~[?:?]
    	at java.base/java.util.Base64$Decoder.decode(Unknown Source) ~[?:?]
    	at org.apache.pulsar.websocket.ReaderHandler.getMessageId(ReaderHandler.java:348) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.ReaderHandler.<init>(ReaderHandler.java:95) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.WebSocketReaderServlet.lambda$configure$0(WebSocketReaderServlet.java:44) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    
    
    **Case 2** — `IOException` wrapping `IndexOutOfBoundsException` from `MessageIdImpl.fromByteArray()`:
    
    WARN  org.apache.pulsar.websocket.ReaderHandler - [REDACTED] Failed in creating reader on topic persistent://REDACTED/REDACTED/REDACTED
    java.io.IOException: java.lang.IndexOutOfBoundsException: readerIndex(5) + length(641882) exceeds writerIndex(12): UnpooledHeapByteBuf(ridx: 5, widx: 12, cap: 12/12)
    	at org.apache.pulsar.client.impl.MessageIdImpl.fromByteArray(MessageIdImpl.java:93) ~[org.apache.pulsar-pulsar-client-original-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.ReaderHandler.getMessageId(ReaderHandler.java:348) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.ReaderHandler.<init>(ReaderHandler.java:95) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.websocket.WebSocketReaderServlet.lambda$configure$0(WebSocketReaderServlet.java:44) ~[org.apache.pulsar-pulsar-websocket-4.0.7.jar:4.0.7]
    Caused by: java.lang.IndexOutOfBoundsException: readerIndex(5) + length(641882) exceeds writerIndex(12): UnpooledHeapByteBuf(ridx: 5, widx: 12, cap: 12/12)
    	at io.netty.buffer.AbstractByteBuf.checkReadableBytes0(AbstractByteBuf.java:1442) ~[io.netty-netty-buffer-4.1.127.Final.jar:4.1.127.Final]
    	at io.netty.buffer.AbstractByteBuf.checkReadableBytes(AbstractByteBuf.java:1428) ~[io.netty-netty-buffer-4.1.127.Final.jar:4.1.127.Final]
    	at io.netty.buffer.AbstractByteBuf.skipBytes(AbstractByteBuf.java:971) ~[io.netty-netty-buffer-4.1.127.Final.jar:4.1.127.Final]
    	at org.apache.pulsar.common.api.proto.LightProtoCodec.skipUnknownField(LightProtoCodec.java:264) ~[org.apache.pulsar-pulsar-common-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.common.api.proto.MessageIdData.parseFrom(MessageIdData.java:304) ~[org.apache.pulsar-pulsar-common-4.0.7.jar:4.0.7]
    	at org.apache.pulsar.client.impl.MessageIdImpl.fromByteArray(MessageIdImpl.java:91) ~[org.apache.pulsar-pulsar-client-original-4.0.7.jar:4.0.7]
    

    Reproducing the issue

    Connect to the WebSocket reader endpoint with an invalid messageId query parameter.

    Two examples that both trigger the bug:

    1. An improperly URL-encoded base64 message ID that includes a + which the server interprets as a space (e.g. CJCj6QEQ+UQwAA== becomes CJCj6QEQ UQwAA==).

    2. An arbitrary non-base64 string: ?messageId=invalidMessageId

    Additional information

    ReaderHandler.getMessageId() performs no validation on the messageId query parameter before passing it to Base64.getDecoder().decode() and MessageIdImpl.fromByteArray().

    ReaderHandler's constructor catches Exception during setup but hardcodes HttpServletResponse.SC_INTERNAL_SERVER_ERROR in the error response. ConsumerHandler and ProducerHandler both call AbstractWebSocketHandler.getErrorCode(e) instead, which maps IllegalArgumentException to SC_BAD_REQUEST (400).

    Are you willing to submit a PR?

    • I'm willing to submit a PR!

    Interface

    No new interfaces are introduced.

    ADDITIONAL ADVICE

    Since you are given a git repository, you can use git commands to simplify your work. For example, if you made a mistake and want to revert your changes, you can use git checkout <file> to restore the file to its original state. You can also reset all changes in the repository using git reset --hard command. Additionally, you can use git stash and git stash pop to temporarily save your changes and restore them later. Finally, you can see the changes that you've made (which will be submitted when you call submit) using git status or git diff commands. However you don't need to use git add or git commit before submitting your changes. In fact, submit only submits currently unstaged changes because it uses git diff to get the changes that need to be submitted.

    CHECKLIST

    Before submitting your solution, please go over the following checklist and make sure you've done everything:

    • If an error was reported in the issue description, I have successfully reproduced it.
    • If an error was reported in the issue description, I have confirmed that my fix resolves the error.
    • I have thought about edge cases and made sure my fix handles them as well.
    • I have run existing tests in the repository that might have been affected by the change I made and confirmed that they pass. I want you to list every bullet from this checklist and write your reasoning for why you think you did it or didn't need to.

    Repository has been uploaded and your shell is currently at the repository root. Time to solve the issue!

    (Current directory: /pulsar, current file: none) bash-$

  2. Claude Assistant

    Now let's fix ReaderHandler: use getErrorCode(e) and wrap exceptions from getMessageId to IllegalArgumentException for base64/parse errors.

  3. Claude Assistant

    Now update ReaderHandler: change error handling to use getErrorCode/getErrorMessage, and wrap getMessageId exceptions into IllegalArgumentException.

  4. Claude Assistant

    I'll use the edit/replace tool commands instead.

  5. Claude Assistant

    Now let's update getMessageId method.

  6. Claude Assistant

    The import is now unused. Let's remove it to avoid checkstyle failures.

  7. Claude Assistant

    Good. Now let's check the full diff and try to compile the module.

  8. Claude Assistant

    Now let's check getMessageId still throws IOException per signature - that's fine since IllegalArgumentException is unchecked. Let's compile module to make sure everything works.

  9. Claude Assistant

    Gradle-based project. Let's try compiling just the websocket module.

  10. Claude Assistant

    Compilation succeeds. Now let's check for existing tests related to ReaderHandler to run them.

  11. Claude Assistant

    Now let's run this test to make sure it still passes.

  12. Claude Assistant

    Test passed silently (no failures reported). Let's check test report for confirmation.

  13. Claude Assistant

    All 3 tests pass. Now let's write a quick reproduction test to confirm the fix works for both cases described in the issue.

  14. Claude Assistant

    Good, it uses getParameterMap(). Let's run this test.

  15. Claude Assistant

    This confirms exactly the bug scenario from the issue (Case 2) is now correctly caught and returns SC_BAD_REQUEST (400). Let's remove the temporary test file now.

  16. Claude Assistant

    Now let's run the full existing test suite for the websocket module to ensure nothing broke.

  17. Claude Assistant

    Confirmed: this test failure is pre-existing and unrelated to our change (fails even on unmodified code, likely due to environment/network limitations in this sandbox). Our change is verified to not introduce new failures.

  18. Claude Assistant

    The diff looks clean and minimal. Let's double check checkstyle passes.

  19. Claude Assistant

    Checkstyle passes with no issues. Let's do a final review of the complete file to ensure correctness.

  20. Claude Assistant

    The implementation looks correct and complete. Let's go through the checklist.

Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.