Error code

KAFKA_PAYLOAD_INVALID

Kafka payload schema invalid

  • HTTP status422
  • Classprogrammer
  • Severityerror
  • Retryableno

Kafka payload schema invalid

A producer or consumer hit a Zod validation failure. On the producer side it’s a code bug; on the consumer side it means an upstream sender broke contract.

Common causes

  • Topic owner shipped a schema change without bumping consumers.
  • Producer constructed a malformed object.
  • Optional field that became required.

What to do

Producer-side: fix the call site immediately. Consumer-side: coordinate a schema migration with the producer team.

סכמת פיילוד Kafka לא תקפה

מפיק/צרכן נכשל בולידציית Zod. בצד המפיק זה באג; בצד הצרכן זה אומר ששולח במעלה הזרם הפר חוזה.

סיבות נפוצות

  • בעל טופיק שינה סכמה מבלי לעדכן צרכנים.
  • המפיק בנה אובייקט פגום.
  • שדה אופציונלי שהפך לחובה.

פעולה מומלצת

בצד המפיק: תקנו את הקריאה מיידית. בצד הצרכן: תאמו מיגרציית סכמה עם הצוות המפיק.