14. Erros de formato e conversão em Eventstreams

Uma mensagem pode chegar ao fluxo e ainda não ser utilizável por uma transformação. O transporte entrega bytes; a desserialização interpreta sua estrutura; a conversão adapta campos aos tipos exigidos. Erros nessas etapas precisam de diagnósticos diferentes.

Formato e desserialização

Confirme o formato configurado e examine o payload recebido. Mudanças de codificação, estrutura ou organização podem impedir a interpretação antes de qualquer filtro. Um array JSON e um objeto JSON representam formas distintas, e o consumidor precisa suportar aquela estrutura.

Pass-through encaminha conteúdo sem necessariamente interpretá-lo. Conseguir transportar um formato até o destino não significa que um operador intermediário consiga acessar seus campos. O suporte deve ser conferido no ponto onde a transformação ocorre, não apenas no sistema final.

Se a mensagem deixa de ser JSON válido, a falha ocorre na interpretação estrutural. Se continua válida, mas temperatura passa de 25 para 25 C, o problema pode ocorrer na conversão do campo. Essa distinção orienta a correção: ajustar parser ou produtor no primeiro caso, e contrato de tipo ou transformação no segundo. Preserve um payload de cada estado para comparar. Sem a entrada original, é fácil atribuir ao operador errado uma falha causada antes dele.

Erro de formato versus conversão

IncorrectDataFormat orienta a conferir a estrutura recebida e o formato configurado. EventStreamErrorMetrics, no monitoramento compatível, ajuda a acompanhar categorias e dimensões de erro, sem substituir a inspeção do payload. Um número entre aspas pode ser JSON válido e ainda exigir conversão explícita para a transformação. Observe o ponto exato da falha antes de alterar parser, tipo ou destino. A correção deve preservar valores válidos e deixar incompatibilidades observáveis.

Conversão e contrato de campos