Kafka gateway: keep repeated header names and header order

Aperta
  • Qualcosa non va?
#4,517 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
30/100
Tipo di issue
Bug
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
rust
Ambito
backend

Direzione di ricerca

Start with gateways/kafka/docs/BRIDGE_MAPPING.md to see how headers are currently mapped and sorted on Fetch. The issue says kafka_protocol keeps only the last value of a repeated header name, so the raw record bytes need to be read for headers. The open question on whether every record or only repeated-name records keep order must be settled before changing the envelope. Done means the KafkaJS array-header producer succeeds and a record with a repeated header name matches after Produce and Fetch.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

gateways

Summary

A record with a repeated header name gets INVALID_RECORD (87), and Fetch returns headers sorted by name (gateways/kafka/docs/BRIDGE_MAPPING.md). Kafka allows both.

Who hits it:

  • KafkaJS writes array header values as repeated keys, a documented feature. If it forwards a consumed message, it writes them again. The KafkaJS layer of confluent-kafka-javascript does the same.
  • Apps that append a trace header twice (https://github.com/spring-projects/spring-kafka/issues/3786).
  • Error 87 fails the whole partition batch in librdkafka, franz-go and Sarama. It puts a kafka-python 3.0 producer in a fatal state, so every later send fails until a restart. A kafka-go writer at its default acks=0 loses the batch and the connection, with no error.

Open question

Does every record keep its header order, at the cost of a larger stored envelope, or only records with repeated names?

Scope

  • Read headers from the raw record bytes, because kafka_protocol keeps only the last value of a name
  • Store a record with repeated names in the envelope, which keeps a list
  • Return headers in their original order on Fetch, as the open question decides
  • Update gateways/kafka/docs/BRIDGE_MAPPING.md

Acceptance criteria

  • A KafkaJS producer with array header values succeeds, and a consumer reads every value in order
  • A record with the same header name twice is the same after Produce and Fetch

References

Lingua principale
Rust
Stelle
5.2k
Fork
502
Merge medio
3g 4h
PR unite (30g)
157

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di apache/iggy

Tutte le issue di apache/iggy

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.