HTTP 410 Gone: o que significa e como corrigir

O que este erro significa e como reconhecê-lo

• Um navegador, cliente de API, crawler, ferramenta de monitoramento ou verificador de disponibilidade informa 410 Gone.
• A resposta pode afetar um URL, padrão de caminho, método HTTP ou versão de API, em vez de todo o site.
• O DNS ainda pode resolver e o TLS ainda pode ser concluído, pois a requisição chegou a um endpoint HTTP.
• Os cabeçalhos da resposta podem revelar o comportamento de cache, o destino de um redirecionamento, o contexto de autenticação, informações sobre o proxy ou a CDN, ou o servidor que processou a requisição.
• Repetir a requisição geralmente retorna o mesmo resultado quando o recurso foi removido intencionalmente.

Causas principais, por probabilidade

Causas mais prováveis

1. Remoção ou descontinuação intencional do recurso — O responsável removeu permanentemente uma página, arquivo, endpoint de API ou versão e configurou o endereço antigo para retornar 410.
2. Regra de aplicação ou roteamento — A aplicação mapeia uma rota desativada, um registro excluído ou uma versão de API sem suporte para 410.
3. Configuração de rewrite ou virtual host do servidor web — Uma regra de rota, alteração de deploy ou configuração incorreta do site retorna 410 para um URL que ainda deveria funcionar.
4. Comportamento de proxy reverso ou CDN — Um intermediário pode ter armazenado em cache ou gerado a resposta com base na configuração de roteamento, cache ou edge.
5. Incompatibilidade na requisição — O URL pode ser válido para um método ou formato de caminho, mas removido ou sem suporte para o método utilizado.
6. Lógica personalizada de segurança ou tratamento de requisições — Um WAF, gateway ou política da aplicação pode usar deliberadamente o 410, embora problemas de autenticação, autorização e limite de requisições geralmente usem outros códigos de status.

O código de status, sozinho, não identifica qual componente produziu a resposta. São necessários cabeçalhos da resposta, timestamps e logs para diferenciar uma remoção intencional de uma regra acidental ou de uma resposta desatualizada de um intermediário.

Como corrigir

Se você está acessando o site

1. Verifique o endereço com atenção, incluindo hostname, caminho, ortografia, uso de maiúsculas e minúsculas e qualquer segmento de versão.
2. Tente novamente o URL exato uma vez, sem atualizá-lo repetidamente. Se a página exigir uma conta, faça login pelo processo normal do site e tente novamente.
3. Se você chegou ao URL por um favorito antigo, resultado de busca ou link externo, procure a navegação atual do site ou uma substituição anunciada. Não presuma que um 410 tenha um destino equivalente.
4. Se a resposta continuar aparecendo e o recurso ainda deveria existir, envie ao responsável pelo site o URL, o horário da requisição, o método HTTP e o resultado 410 exibido. Não envie senhas, cookies ou tokens de acesso.

Se você é responsável pelo site ou pelo desenvolvimento

1. Reproduza a requisição exata. Registre o URL, o método HTTP, o host, os parâmetros de consulta, o status, os cabeçalhos da resposta e se a requisição foi autenticada. Compare a requisição com falha a uma rota ou método relacionado que esteja funcionando.
2. Decida se o 410 é intencional. Confirme se a página, o arquivo, o registro ou a versão da API foi removido deliberadamente. Se foi, documente a remoção e mantenha a resposta, a menos que seja necessária uma substituição adequada.
3. Identifique a camada que produz a resposta. Verifique se os cabeçalhos e o caminho da requisição indicam que a aplicação, o servidor web, o proxy reverso, a CDN ou o WAF gerou a resposta. Analise cada camada no caminho da requisição, em vez de alterar todas ao mesmo tempo.
4. Inspecione os logs correspondentes. Pesquise os logs relevantes de acesso, aplicação, proxy, CDN ou segurança usando o timestamp, a rota e o identificador da requisição. Procure uma regra de remoção, registro excluído, rewrite, alteração de deploy ou resposta armazenada em cache.
5. Verifique alterações recentes e o estado do cache. Compare a configuração de roteamento, versionamento da API, autenticação, rewrite e cache de edge com o último deploy conhecido como funcional. Se um intermediário armazenou uma resposta incorreta em cache, siga o processo documentado e autorizado de invalidação de cache, em vez de desativar o cache de forma ampla.
6. Aplique a correção autorizada mais restrita. Restaure a rota ou remova a regra incorreta somente quando o recurso deveria estar disponível. Se existir uma substituição equivalente, configure e teste um redirecionamento deliberado; não redirecione URLs sem relação ou inexistentes apenas para ocultar o 410.
7. Teste novamente a mesma requisição. Verifique o status, os cabeçalhos e o corpo da resposta no cliente relevante e, quando aplicável, a partir da rede ou localização de edge afetada. Confirme que as rotas removidas intencionalmente continuam se comportando conforme documentado e que as rotas relacionadas mantêm os status pretendidos.
8. Revise o monitoramento e a documentação. Atualize os inventários de rotas, avisos de descontinuação de API, redirecionamentos e testes para que uma versão futura não remova acidentalmente um recurso ativo.

Prevenção e como verificar a correção

• Mantenha um inventário das rotas web, arquivos e versões de API importantes, incluindo o comportamento de remoção esperado para cada um.
• Trate remoções intencionais como alterações de release: documente-as, teste-as e identifique qualquer URL de substituição aprovado.
• Mantenha a configuração da aplicação, do servidor web, do proxy, da CDN e do WAF sob controle de versão e revise as alterações de rota antes do deploy.
• Teste URLs e métodos de API importantes após releases, migrações e descontinuações.
• Monitore as taxas de status HTTP por rota, método e deploy para diferenciar respostas 410 inesperadas de remoções planejadas.
• Mantenha os logs de acesso e da aplicação pelo tempo necessário para correlacionar uma resposta à camada responsável.
• Defina procedimentos de invalidação de cache e rollback para respostas acidentais do edge ou do proxy.

Perguntas frequentes