Skip to content

message-bus: rethrow handler errors, skip poison messages - #2

Open
ludamad wants to merge 1 commit into
mainfrom
kafka-handler-rethrow
Open

message-bus: rethrow handler errors, skip poison messages#2
ludamad wants to merge 1 commit into
mainfrom
kafka-handler-rethrow

Conversation

@ludamad

@ludamad ludamad commented Aug 18, 2026

Copy link
Copy Markdown

The eachMessage wrapper swallowed handler exceptions, so kafkajs resolved the offset even when the handler's database write had failed — silently losing the event. Meanwhile a message failing BSON deserialization threw outside the catch, crash-looping the partition on a permanently bad message. Both inverted to correct behavior: handler errors rethrow (offset unresolved → kafkajs redelivers; handlers are id-keyed upserts so replay is safe), undeserializable messages are logged and skipped.

From the production-readiness audit's immediate work order #1. Intended for upstream aztec-scan/chicmoz as well.

🤖 Generated with Claude Code

https://claude.ai/code/session_015mXnawSBPUySPtPwjLp5g1

The eachMessage wrapper swallowed handler exceptions, so kafkajs
resolved the offset even when the handler's database write had failed —
silently losing the event. Meanwhile a message that failed BSON
deserialization threw outside the catch, crash-looping the partition on
a permanently bad message. Both are inverted to the correct behavior:

- handler errors are rethrown so the offset is not resolved and kafkajs
  redelivers (at-least-once; handlers are id-keyed upserts, safe to
  replay)
- undeserializable messages are logged and skipped: retrying a poison
  pill can never succeed

Identified in the AztecScan production-readiness audit (failed-message
acknowledgement, immediate work order #1).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015mXnawSBPUySPtPwjLp5g1
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants