KIP-1242 — Detection and handling of misrouted connections
Accepted BrokerProtocol
Introduces misrouted-connection detection by having the broker send a DisconnectResponse (or equivalent signal) when a client connects to the wrong broker, enabling the client to refresh metadata and reconnect correctly. In Kubernetes rolling restarts, a broker can change its advertised hostname and a client using stale bootstrap metadata silently connects to the wrong broker, leading to confusing failures that require a full client restart to resolve.
Details
| Author | Andrew Schofield |
| Status | Accepted |
| JIRA | KAFKA-20246 |
| Wiki | View on Apache Wiki |
| Created | 2025-11-20 |
| Last Modified | 2026-03-14 |
Explore how this KIP affects the Kafka protocol in the Protocol Explorer, or see the full KIP database.