O Que É um Hydration Mismatch?

Um hydration mismatch ocorre quando um framework do cliente anexa comportamento ao HTML renderizado no servidor, mas a marcação que ele calcula não corresponde ao que o servidor enviou. O framework espera que os dois sejam idênticos para poder reusar o DOM. Quando diferem, muitas vezes por valores dependentes de tempo ou exclusivos do navegador, ele avisa e pode descartar e re-renderizar a marcação.

Por que isso importa

Mismatches causam flicker visível, estado perdido ou controles que não funcionam logo após o carregamento. Pegá-los em testes ou verificações em tempo de build evita lançar uma primeira renderização sutilmente quebrada.

Guias relacionados