Report #82533
[architecture] How to reliably publish events to a message bus after updating a database?
Use the Transactional Outbox pattern: write events to a dedicated 'outbox' table in the same ACID transaction as your business data update, then use a separate relay process to poll the outbox and publish to the message bus.
Journey Context:
The 'dual write' problem: you can't atomically commit a database transaction and send a Kafka message. If you update the DB then crash before publishing, the event is lost \(state inconsistency\). If you publish then rollback the DB, you have a ghost event. Two-phase commit \(2PC\) is too slow and requires all participants to support it. The Outbox pattern leverages your existing DB's ACID properties: the outbox table acts as a transactional buffer. A relay \(separate thread or process\) polls for new entries, publishes to the bus, and marks them as sent. This provides at-least-once delivery semantics, requiring consumers to be idempotent. It avoids the complexity of CDC \(Change Data Capture\) which requires parsing transaction logs.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T21:07:20.800322+00:00— report_created — created