Pular para o conteúdo

O AI bot está recebendo dados antigos por causa de hydration mismatch? Compare o SSR e o HTML do cliente com 6 verificações

O AI bot está recebendo dados antigos por causa de hydration mismatch? Compare o SSR e o HTML do cliente com 6 verificações

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 suppressHydrationWarning como 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.

Perguntas frequentes

Hydration mismatch sempre significa que os bots de AI estão lendo dados antigos?

Não. O mismatch mostra que o HTML do servidor e a primeira renderização do cliente são diferentes. A diferença pode existir apenas por causa da hora ou de um valor aleatório. O risco de dados antigos aumenta especialmente quando o conteúdo atualizado é carregado apenas no cliente ou quando a resposta SSR fica em cache.

O que fazer quando o conteúdo não aparece com JavaScript desativado?

Coloque o título, a descrição, o preço, o estoque ou o corpo do artigo crítico no SSR e no HTML inicial. O fetch do lado do cliente deve ser usado apenas para atualização, e a primeira renderização do cliente deve ser idêntica aos dados iniciais enviados pelo servidor.

Usar suppressHydrationWarning resolve problemas de SEO?

Geralmente não. Esse recurso pode suprimir um aviso específico de hydration; mas não corrige HTML bruto antigo ou incompleto, problemas de cache no CDN ou conteúdo que só aparece depois do JavaScript. Primeiro, corrija o fluxo de geração de dados e de cache.

Como comparar rapidamente o SSR com o HTML do cliente?

Primeiro, salve a resposta bruta em um arquivo com curl. Depois, exporte o DOM ao vivo no navegador com JavaScript ativado e compare os nós de conteúdo críticos nos dois arquivos com diff. Não se esqueça de que View Source e Elements mostram camadas diferentes.

Escaneie seu site grátis