HTTP 301 Moved Permanently: o que significa

O que este erro significa e como reconhecê-lo

• Um navegador, cliente de API, serviço de monitoramento ou verificador HTTP informa 301 Moved Permanently.
• Um navegador pode seguir o redirecionamento automaticamente, exibir uma URL diferente ou revelar um loop de redirecionamento se o destino levar de volta à URL original.
• A resposta pode incluir um cabeçalho Location contendo o destino do redirecionamento.
• O comportamento pode ocorrer somente para uma URL, hostname, método HTTP, estado de autenticação, user agent ou caminho de rede específico.
• O DNS pode resolver corretamente e o TLS pode ser concluído com sucesso porque o endpoint retornou uma resposta HTTP.
• Clientes de API ou ferramentas automatizadas podem parar no 301 em vez de segui-lo, dependendo das configurações de redirecionamento.

Causas principais, por probabilidade

1. Canonização intencional de URL: o site redireciona um hostname alternativo, caminho, formato com barra final ou outra variante de URL para o endereço preferencial.
2. Migração de protocolo ou hostname: o tráfego HTTP pode ser redirecionado para HTTPS, ou um hostname antigo pode apontar para um hostname substituto.
3. Roteamento da aplicação ou do framework: a aplicação pode redirecionar uma rota após uma alteração de caminho, mudança no estado de login ou realocação de recurso.
4. Regras do servidor web, reverse proxy ou CDN: a configuração da infraestrutura pode aplicar um redirecionamento antes que a solicitação chegue à aplicação.
5. Comportamento de redirecionamento em cache: um navegador, cache intermediário ou CDN pode continuar fornecendo um redirecionamento armazenado anteriormente enquanto as alterações de configuração são propagadas.
6. Comportamento específico do método: uma regra de redirecionamento pode ser adequada para a navegação em um navegador, mas inadequada para uma solicitação de API ou para um método que precise preservar a semântica da solicitação.
7. Regras inesperadas ou conflitantes: várias camadas podem redirecionar para destinos diferentes, criando uma cadeia ou um loop.

Como corrigir

Se você está visitando o site

1. Verifique o endereço exato, incluindo hostname, caminho e protocolo. Siga o redirecionamento somente se o destino for conhecido e esperado.
2. Se o destino exigir uma conta, faça login pela interface normal do site e tente novamente. Não forneça credenciais a um domínio redirecionado desconhecido.
3. Se um navegador chegar à página pretendida, o 301 pode estar funcionando conforme projetado. Se houver um loop, se o navegador chegar ao host errado ou terminar em uma página inexistente, registre a URL original e o destino.
4. Para uma API ou cliente automatizado, verifique se ele segue redirecionamentos e se a URL redirecionada é válida para o mesmo método de solicitação e contexto de autenticação.
5. Informe ao proprietário do site a URL original, o destino, o horário aproximado, o tipo de cliente e o status observado. Não compartilhe senhas, cookies ou segredos de API.

Se você é proprietário ou responsável pela manutenção do site

1. Reproduza a solicitação exata. Registre o método HTTP, a URL completa, o host, o protocolo, o estado de autenticação quando relevante, o status final e cada destino de redirecionamento.
2. Inspecione os cabeçalhos de resposta, especialmente Location, os cabeçalhos relacionados a cache e autenticação e qualquer cabeçalho que identifique uma camada de proxy ou servidor.
3. Determine qual componente produziu o 301: aplicação, servidor web, reverse proxy, CDN ou WAF. Verifique os logs correspondentes usando o horário da solicitação e um identificador de solicitação, se disponível.
4. Compare o comportamento com o projeto de roteamento pretendido. Confirme se o redirecionamento deve lidar com uma alteração de hostname, política de HTTP para HTTPS, caminho canônico, recurso movido ou fluxo da aplicação.
5. Verifique se há cadeias de redirecionamento, loops, regras conflitantes e um destino incorreto. Analise implantações recentes e alterações no roteamento, na autenticação, no cache e na configuração de proxy ou CDN.
6. Aplique a correção autorizada mais restrita na camada que gerou a resposta. Evite alterações amplas em permissões, segurança ou regras de redirecionamento quando apenas uma rota ou condição estiver incorreta.
7. Teste novamente a mesma URL e o mesmo método usando um cliente apropriado. Em seguida, teste o destino, as rotas relacionadas importantes e os casos relevantes autenticados e não autenticados.
8. Se houver suspeita de um redirecionamento em cache, siga o processo aprovado de invalidação de cache do site e considere seu impacto operacional antes de fazer essa alteração.

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

• Defina e documente os redirecionamentos intencionais, incluindo URLs antigas, destinos, métodos afetados e responsáveis.
• Mantenha as regras do servidor web, da aplicação, do reverse proxy, da CDN e do WAF sob controle de versão quando houver suporte.
• Teste URLs canônicas, o comportamento de HTTP para HTTPS, alterações de hostname, métodos importantes de API e rotas autenticadas após as implantações.
• Monitore taxas, cadeias e loops de redirecionamento por rota e implantação, em vez de tratar todo 301 como uma indisponibilidade.
• Mantenha os logs de solicitações e da infraestrutura disponíveis por tempo suficiente para correlacionar redirecionamentos inesperados.
• Analise o comportamento do cache ao alterar regras de redirecionamento para que respostas antigas não ocultem o resultado de uma correção.

Perguntas frequentes