Um documento público ausente deve apresentar uma explicação clara e retornar um código de status HTTP apropriado, geralmente 404. Em um Mac, você pode verificar ambos no Chrome, identificar a incompatibilidade e fornecer ao seu sistema de publicação uma correção precisa.

Este fluxo de trabalho é para quem mantém páginas de documentos públicos: guias, notas de referência ou folhas de instruções simples. O objetivo é fazer com que o endereço solicitado, a resposta do servidor e a mensagem exibida estejam de acordo. Todos os caminhos de exemplo abaixo são fictícios.

Qual resposta um documento ausente deve retornar?

Primeiro, decida o que deve acontecer no endereço do documento. Uma página que foi movida requer um tratamento diferente de uma página que deixou de existir. Use esta tabela de decisão antes de alterar o design da página de ausência.

Situação do documento Resposta pretendida O que os leitores devem ver
Existe no endereço solicitado 200 OK O documento completo
Tem um substituto permanente claro Redirecionamento 301 O documento substituto no novo endereço
Não pode ser encontrado e não há substituto equivalente 404 Not Found Uma explicação útil de que o documento não foi encontrado
Foi removido deliberadamente e é provável que a ausência seja permanente 410 Gone é apropriado Uma explicação clara sobre a remoção e uma navegação útil

O HTTP define 404 sem indicar se a ausência é temporária ou permanente. Ele define 410 para um recurso cuja indisponibilidade provavelmente é permanente; quando não se sabe se será permanente, use 404. Essas definições constam da RFC 9110, seções 15.5.5 e 15.5.11.

O Google recomenda um redirecionamento permanente quando um documento foi movido ou tem um substituto claro. Se ele foi removido sem um substituto semelhante, o Google recomenda 404 ou 410. Consulte as orientações do Google para resolver respostas de conteúdo ausente.

Por exemplo, suponha que /documents/paper-folding-notes tenha se tornado /documents/paper-folding-guide, com instruções substancialmente equivalentes. Um redirecionamento permanente é adequado para essa mudança. Se as notas foram removidas sem substituição, mantenha uma resposta de documento ausente no endereço antigo. Essa página pode oferecer um link para um diretório geral de documentos.

Por que um design convincente de página de ausência não é suficiente

Uma página pode exibir claramente a mensagem Documento não encontrado, enquanto o servidor retorna 200. O Google chama esse tipo de incompatibilidade de soft 404; uma página vazia ou sem conteúdo principal também pode receber essa classificação. Leia a explicação do Google sobre erros soft 404.

O status faz parte da resposta HTTP e é separado do conteúdo explicativo. Portanto, alterar o título ou adicionar um grande rótulo 404 não define o código de resposta. Verifique a solicitação real do documento antes de decidir que o problema foi corrigido. A RFC 9110 descreve a função dos códigos de status de resposta.

Como verificar a resposta do documento em um Mac?

Use as ferramentas integradas do Chrome para esta inspeção. Prepare o endereço de um documento que você sabe que funciona e um caminho propositalmente inexistente no mesmo site público. Por exemplo, o caminho ausente pode ser /documents/missing-paper-example-731. Escolha um endereço que você sabe que não contém nenhum documento publicado.

  1. Abra a página pública no Chrome.
  2. Pressione Command + Option + I para abrir o DevTools.
  3. Selecione o painel Network.
  4. Com o DevTools aberto, digite o endereço de teste na barra de endereços e carregue a página.

O Chrome documenta o atalho para Mac em Abrir o Chrome DevTools. A atividade de rede é registrada enquanto o DevTools está aberto, conforme explicado na visão geral do painel Network.

  1. Selecione Disable cache para evitar depender da resposta armazenada em cache pelo navegador durante esta verificação.
  2. Ative Preserve log se precisar acompanhar a navegação durante os redirecionamentos.
  3. Recarregue o endereço de teste.
  4. Selecione a solicitação principal do documento e abra Headers. Em General, leia o endereço solicitado e o código de status.

Esses controles e a localização das informações de status estão documentados na referência de recursos do Network do Chrome.

Verifique com atenção a solicitação do documento. O registro também contém solicitações de scripts, estilos e outros recursos. A ausência de um arquivo de apoio não demonstra que o próprio documento retornou 404. A tabela de solicitações do Chrome distingue o código HTTP em Status e a categoria do recurso em Type; consulte Inspecionar a atividade de rede.

Agora compare três observações: o endereço solicitado originalmente, o código de resposta desse documento e a página exibida após o carregamento. Registre os três juntos. Se a navegação mudar o endereço, inspecione a solicitação original e o destino, em vez de registrar apenas a página final.

Como transformar as observações em uma correção?

A tabela de diagnóstico a seguir é uma síntese prática dos significados HTTP e das orientações de solução de problemas do Google. Ela serve como auxílio para tomar decisões, não como conjunto de resultados medidos.

Resultado observado O que investigar Correção pretendida
200 com uma mensagem de documento ausente O manipulador de rotas ausentes ou a alternativa padrão Retorne 404 com a explicação
404 com o documento esperado visível A resposta atribuída a uma rota existente Sirva o documento corretamente com 200
Redirecionamento para um diretório genérico Se existe um substituto equivalente Redirecione para o documento equivalente ou exiba uma página de ausência
200 com um documento em branco ou incompleto Carregamento e renderização do conteúdo Restaure o conteúdo pretendido se o documento ainda existir
404 com uma mensagem útil de página de ausência Se o endereço realmente não existe Mantenha esse comportamento se a ausência for pretendida

A documentação de solução de problemas do Google distingue explicitamente documentos indisponíveis, documentos que foram movidos e documentos que ainda existem, mas não carregam corretamente. Essa distinção evita tratar uma página existente e incompleta como se tivesse sido removida intencionalmente. Consulte Solucionar erros de rastreamento da Pesquisa Google.

Para encaminhar uma solicitação concreta, escreva: “Para o caminho fictício ausente /documents/missing-paper-example-731, retorne 404 e exiba a página personalizada de documento ausente nesse endereço. Mantenha os caminhos de documentos existentes funcionando. Aplique redirecionamentos permanentes somente quando for identificado um substituto equivalente.” Acrescente o status observado e a mensagem visível da sua verificação.

Essa solicitação descreve o comportamento necessário sem tentar adivinhar os nomes dos menus do seu sistema de publicação. A implementação deve ocorrer na configuração da hospedagem, na rota da aplicação ou no sistema de publicação que gera a resposta. O Google explica que os códigos de status HTTP são gerados pelo servidor de hospedagem na documentação sobre códigos de status HTTP.

E se o editor só permitir alterar o conteúdo da página?

Um editor que altera texto ou metadados do documento talvez não controle as respostas HTTP. O padrão HTML WHATWG define comportamentos específicos para diretivas meta usando http-equiv; definir um status de resposta HTTP não está entre eles. Portanto, adicionar http-equiv="status" não é uma forma compatível de criar um 404. Consulte Padrão HTML: Diretivas Pragma.

Quando não há controles de resposta no editor, use o mecanismo documentado de página de ausência da camada de hospedagem ou da aplicação. Pergunte se ela serve o conteúdo personalizado com 404 no endereço solicitado que não existe. Uma configuração que apenas escolhe o layout da página de erro não responde a essa pergunta; verifique o resultado usando o fluxo de trabalho no navegador.

Um exemplo documentado para páginas estáticas na Netlify

Para um site estático existente na Netlify, o mecanismo documentado é um arquivo chamado 404.html. A Netlify o usa automaticamente em caminhos inválidos que não correspondem a um arquivo estático. Este é um exemplo específico de provedor, com pré-requisitos: acesso à saída final do site e uma compilação de páginas estáticas existente. A Netlify documenta o tratamento personalizado de 404.

  1. Use o modelo de página existente no site para criar a página de documento ausente.
  2. Verifique se a saída final inclui 404.html na raiz do diretório de publicação.
  3. Verifique se nenhuma regra de roteamento anterior envia endereços desconhecidos para outra página.
  4. Depois que a saída revisada estiver disponível no endereço público, inspecione um caminho ausente e um documento funcional.

A verificação de roteamento é importante porque a Netlify processa o roteamento antes de chegar ao tratamento de arquivos estáticos e à página de ausência final. Uma solicitação já tratada anteriormente não chegará a esse manipulador final. A documentação Request Chain explica a ordem. Este exemplo descreve um caminho de correção; não indica que algum site tenha sido alterado.

Limite para aplicações com roteamento no navegador

Algumas aplicações só descobrem que um documento está ausente depois que o JavaScript é executado. O Google reconhece que pode ser impraticável retornar códigos de status significativos em roteamentos no lado do cliente. As alternativas documentadas são um redirecionamento JavaScript para um endereço cujo servidor retorna 404 ou a adição de metadados noindex à página de erro. Consulte as orientações do Google para SEO com JavaScript.

Essas alternativas têm resultados diferentes. O redirecionamento leva a um novo endereço com uma resposta genuína de página ausente. A abordagem com metadados trata da indexação, mas mantém inalterado o status HTTP original. Se o requisito é manter o endereço original do documento e retornar 404 nele, a resposta da hospedagem ou da aplicação precisa oferecer esse comportamento.

O que a página de documento ausente deve dizer?

Use uma mensagem curta e específica, como Não foi possível encontrar este documento. Em seguida, ofereça uma próxima ação útil: um link para o diretório de documentos ou outro destino de navegação verificado. Mantenha a navegação e a aparência habituais do site. O Google recomenda linguagem clara, design consistente e links úteis para páginas de ausência personalizadas.

Para o exemplo fictício de dobradura de papel, um texto adequado seria: Não foi possível encontrar este documento sobre dobradura de papel. Acesse o diretório de documentos para escolher outro guia. Só descreva um documento como removido permanentemente quando isso for conhecido. Mantenha a explicação visível em vez de enviar imediatamente todos os endereços ausentes para outro lugar.

Como verificar se a resposta e a página estão de acordo?

Repita a inspeção com um pequeno conjunto de comparação. Os resultados esperados abaixo são critérios de aceitação ilustrativos, não resultados de testes relatados.

Caso de teste Resposta e página esperadas
Documento que se sabe que funciona 200, com o documento completo
Caminho propositalmente inexistente 404, com a explicação de documento ausente
Documento removido sem substituto 404 ou 410, quando apropriado, com uma explicação precisa
Documento movido com substituto equivalente Redirecionamento permanente, seguido da resposta bem-sucedida do substituto

Teste novamente digitando cada endereço diretamente e recarregando-o, inclusive documentos normalmente acessados pela navegação da página. Isso verifica a resposta recebida por uma nova solicitação de documento. Mantenha juntos o endereço, o código e o resultado visível para que um destino bem-sucedido não oculte uma resposta anterior incorreta durante a navegação.

Se um resultado antigo persistir, diferencie o cache do navegador de outros caches. Desativar o cache do Chrome afeta o cache do navegador. O cache HTTP também pode armazenar respostas negativas, como 404, portanto uma resposta de ausência desatualizada pode exigir uma verificação do comportamento documentado de cache do sistema de publicação. A RFC 9111 explica os resultados negativos que podem ser armazenados em cache.

Na Pesquisa Google, uma resposta genuína de ausência tem uma consequência esperada: o Google não indexa URLs que retornam 404 ou 410, e os URLs indexados anteriormente são removidos à medida que essas respostas são processadas. Uma resposta bem-sucedida 200 também não garante a indexação. Consulte Como os códigos de status HTTP afetam os rastreadores do Google.

Conclua quando cada endereço testado apresentar uma situação coerente: documentos disponíveis carregam corretamente, documentos movidos levam aos substitutos e documentos ausentes retornam uma resposta apropriada de ausência com navegação útil. Assim, você terá uma verificação de publicação concreta e repetível no seu Mac.

Fontes