A legibilidade para AI é a capacidade de informações importantes de uma página web serem capturadas por agentes de inteligência artificial de forma correta, atualizada e compreensível por máquinas. Por exemplo, se o preço do produto aparece como 1.299 TL no HTML gerado pelo servidor, mas 1.249 TL no navegador depois que o JavaScript é executado, isso significa que existem duas camadas de conteúdo. Resposta curta: hydration mismatch, por si só, não envia necessariamente dados antigos ao AI bot; mas se as informações atualizadas forem carregadas apenas no lado do cliente ou se a saída do SSR permanecer em cache, alguns agentes podem ler dados antigos ou incompletos no primeiro HTML.
Por isso, o objetivo não é apenas produzir uma página que pareça correta no navegador, mas medir a diferença entre a resposta HTTP bruta, a visualização com JavaScript desativado e o DOM após o JavaScript. Nem todos os sistemas de AI usam o mesmo método de rastreamento: alguns processam apenas a resposta HTTP, enquanto outros podem usar um navegador que executa JavaScript. Em vez de assumir qual camada está sendo lida, aplique as 6 verificações na mesma URL.
Como o hydration mismatch leva dados antigos ao AI bot?
Hydration mismatch ocorre quando o HTML do servidor e a primeira renderização do React no cliente são diferentes. O risco de dados antigos geralmente surge da combinação entre cache stale de SSR, busca de dados no lado do cliente e valores que mudam com o tempo. Portanto, o mismatch é um sintoma; a inconsistência no fluxo de dados é o verdadeiro ponto de análise.
SSR é o HTML inicial enviado pelo servidor ao navegador. Esse HTML é o conteúdo que pode ser visto mesmo antes da execução de qualquer JavaScript. Durante a hidratação, o React conecta listeners de eventos a essa marcação e faz a correspondência com sua árvore virtual. Se a primeira renderização no cliente diferir do texto, dos atributos ou da estrutura de nós no servidor, pode surgir um erro ou aviso no console. Mesmo que o React consiga corrigir algumas diferenças de texto, isso não significa que o conteúdo permanecerá atualizado para todos os bots.
Em quais 6 verificações você encontra a diferença entre SSR e HTML do cliente?
1. O primeiro HTTP response contém dados atualizados?
Primeiro, registre o que o servidor envia sem executar JavaScript. Se o corpo da resposta não contiver título, preço, estoque, data ou dados estruturados, o conteúdo não poderá ser lido antes da execução de JS. Se a resposta estiver desatualizada, o problema está antes do hydration, na fonte de dados ou na camada de cache.
No terminal, capture a mesma URL com diferentes valores de User-Agent. User-Agent sozinho não imita um crawler real de AI; ainda assim, pode mostrar se as regras do CDN ou do servidor retornam respostas diferentes.
curl -sSL -D headers.txt -A 'Mozilla/5.0' 'https://ornekalanadi.com/urun/abc' -o ssr-browser.html
curl -sSL -D ai-headers.txt -A 'GPTBot' 'https://ornekalanadi.com/urun/abc' -o ssr-ai.html
grep -in '1.249|stokta|Product' ssr-browser.html
2. O que muda entre View Source e o DOM ao vivo?
O View Source no navegador mostra, em grande parte, o HTML bruto vindo do servidor; o painel Elements mostra o DOM ao vivo após o JavaScript. Salve essas duas saídas separadamente e compare os nós de conteúdo importantes. Se os valores de preço, descrição, data e JSON-LD não forem os mesmos, identifique a origem da diferença.
A existência de uma diferença nem sempre é um erro de SEO. Por exemplo, o fato de o React conectar um event listener não altera o texto visível. Por outro lado, remover no cliente um texto de estoque que existe no servidor, ou adicionar conteúdo apenas no cliente, pode afetar diretamente a legibilidade para AI.
3. Em qual componente ocorre o erro de hydration do React?
Registre o aviso de hydration no console do navegador e as informações do component stack. Nas versões React 18 e posteriores, você pode usar onRecoverableError para hydrateRoot e monitorar eventos em ambiente de produção. Se apenas o log for silenciado, isso não significa que o problema foi resolvido.
hydrateRoot(root, <App initialData={initialData} />, {
onRecoverableError(error, info) {
console.warn('Hydration farkı', error.message, info.componentStack);
}
});
Registre a mensagem de erro junto com a URL, o componente e a versão dos dados; não envie dados pessoais. Se o mesmo aviso aparecer em 3 componentes diferentes em uma página, procure um formato de data, locale ou gerador de dados iniciais em comum.
4. Data, hora, locale ou valores aleatórios mudam a primeira renderização?
Date.now(), Math.random(), fuso horário do navegador, formato monetário e fontes como window podem produzir resultados diferentes no servidor e no cliente. Gere uma data ISO fixa no servidor ou um rótulo já formatado; no cliente, atualize o valor variável dentro de useEffect após o hydration.
Por exemplo, se o servidor estiver em UTC e o navegador em Europe/Istanbul, o mesmo timestamp pode cair em outro dia. Se você precisar exibir uma data precisa no primeiro HTML, transporte o texto e a versão dos dados juntos no mesmo payload do servidor para o cliente.
5. Os dados atualizados vêm apenas de um fetch no cliente?
Se um conteúdo é buscado dentro de useEffect, ele pode não aparecer em clientes com JavaScript desativado nem em agentes que leem apenas a resposta HTTP. Para informações críticas, coloque os dados iniciais na resposta SSR. O fetch do cliente pode trazer a atualização final; mas a primeira renderização deve partir do mesmo valor inicial.
Se o preço do produto gerado pelo SSR às 10:00 for diferente do preço obtido pela API no cliente às 10:01, isso pode ser uma atualização esperada. Porém, se o AI agent processa apenas o primeiro HTML, ele nunca verá o segundo preço. Relate essa diferença junto com a origem do conteúdo, o momento de geração e o horário de resposta da API.
6. O CDN, ISR ou cache da aplicação está mantendo uma saída SSR antiga?
Inspecione Age, ETag, Last-Modified, Cache-Control nos cabeçalhos de resposta e o status de cache específico do CDN. Mesmo que o servidor busque o preço atualizado no banco de dados, o CDN pode continuar devolvendo HTML antigo por 300 segundos. Quando o conteúdo mudar, use purge, revalidation curta ou uma política adequada de no-store.
Um teste com parâmetro de consulta aleatório que desativa o cache nem sempre representa o caminho real do visitante. Por isso, compare a URL normal a partir de 2 ou 3 redes diferentes, com os mesmos headers e registrando o timestamp. Se o corpo da resposta 200 for diferente, verifique também a regra de variação.
Lista de verificação técnica
- Salve o HTML bruto da página com
curl; marque o texto importante, canonical e os campos JSON-LD. - Compare a saída do View Source com o DOM do Elements após o JavaScript; separe não só classes ou listeners de eventos, mas também diferenças no conteúdo visível.
- Desative o JavaScript e teste se as informações necessárias do produto, artigo ou serviço ainda podem ser lidas.
- Monitore os avisos do console do React com URL, componente e versão dos dados; não trate
suppressHydrationWarningcomo uma correção. - Remova data, hora, locale e valores aleatórios da primeira renderização ou transporte o mesmo valor do servidor para o cliente.
- Valide os fluxos de TTL, ETag, revalidation e purge no CDN e no cache da aplicação no momento da atualização do conteúdo.
Cenário de exemplo: o preço do produto está antigo no SSR, mas atualizado no DOM
Em uma página de e-commerce, o ERP atualiza o produto para 1.249 TL. Porém, por causa de um TTL de 300 segundos no CDN, o servidor continua devolvendo HTML com 1.299 TL. O componente React faz uma chamada à API após o hydration e mostra 1.249 TL no navegador. Enquanto o usuário vê o preço correto no Elements panel, um leitor de AI que não executa JavaScript pode encontrar 1.299 TL no HTML bruto.
A correção certa não é apenas desligar o aviso de hydration. Garanta que o SSR busque dados da fonte atualizada, que o CDN seja limpo após a atualização do ERP e que o cliente use o mesmo valor inicial. O padrão abaixo preserva o rótulo do servidor na primeira renderização do cliente e só muda de forma controlada depois que a resposta da API chega:
function Price({ initialLabel, initialValue }) {
const [price, setPrice] = useState({
label: initialLabel,
value: initialValue
});
useEffect(() => {
fetch('/api/price/abc', { cache: 'no-store' })
.then(response => response.json())
.then(nextPrice => setPrice(nextPrice));
}, []);
return <p data-price={price.value}>{price.label}</p>;
}
Aqui, initialLabel e initialValue precisam ser transmitidos do SSR para o cliente de forma idêntica. A resposta da API pode retornar, por exemplo, { label: '1.249 TL', value: 1249 }. Durante o teste, primeiro salve o arquivo ssr.html, depois o DOM no navegador com JavaScript ativado; em seguida, use diff -u para analisar não só o nó do preço, mas também o JSON-LD e os textos de acessibilidade.
Se a página realmente atualiza dados variáveis no cliente, meça quando essa atualização acontece. Por exemplo, um fetch concluído em 180 milissegundos pode ser visível para o usuário no navegador; mas um agente que nunca renderiza a resposta do servidor não vivencia esse intervalo. Do ponto de vista de legibilidade para AI, a informação crítica deve estar no primeiro HTML e o valor ali presente deve estar alinhado com a política de dados válida.
Erros comuns
- Achar que silenciar o aviso de hydration resolve conteúdo antigo ou incompleto.
- Ver apenas um screenshot e nunca inspecionar a resposta HTTP bruta.
- Deixar o preço, o estoque ou o corpo do artigo exclusivamente para uma chamada de API dentro de
useEffect. - Usar locale, fuso horário ou formato monetário diferentes no servidor e no cliente.
- Assumir que a atualização do conteúdo foi publicada imediatamente sem validar a limpeza do cache no CDN.
- Generalizar o comportamento de um bot de navegador para todos os agentes de AI.
Em resumo, hydration mismatch é um sinal de que você precisa comparar primeiro a saída do SSR com a primeira renderização do cliente. Para entender se os dados antigos realmente estão chegando ao AI bot, avalie juntos a resposta bruta, a visualização com JavaScript desativado, o DOM ao vivo, os logs do React e os cabeçalhos de cache na mesma URL.