conduktor.io ↗

KIP-1259 — Add configuration to wipe Kafka Streams local state on startup

Accepted Kafka 4.3 Streams

Adds a startup configuration flag (state.dir.wipe.on.startup or equivalent) that causes Kafka Streams to delete all local state store data and checkpoint files before restoring from changelogs. A zombie-data edge case occurs when an instance restarts with stale local state after the changelog's delete.retention.ms has expired: the local checkpoint offset still exists on the broker but the corresponding changelog records have been deleted, causing silent state corruption on restore.

Details

AuthorUladzislau Blok
StatusAccepted
Kafka Version4.3
JIRAKAFKA-19943
WikiView on Apache Wiki
Created2025-12-21
Last Modified2026-03-01
Explore how this KIP affects the Kafka protocol in the Protocol Explorer, or see the full KIP database.