Gerenciando mais de 10.000 redirecionamentos 301: o que quebra e o que escala

Dez mil redirecionamentos chegam mais rápido do que a maioria das equipes espera: uma migração de plataforma de uma loja online, duas mudanças de marca, alguns anos de URLs de campanhas. Os redirecionamentos em si são simples. O que muda nessa escala é a velocidade, quem pode alterá-los e se alguém ainda consegue dizer quais realmente importam.

O que quebra depois de 10.000 redirecionamentos#

• Velocidade. As listas de regras são verificadas de cima para baixo. Dez mil linhas de RewriteRule em .htaccess são lidas e testadas em cada requisição, inclusive nas requisições de páginas que nem sequer redirecionam.
• Cadeias. Cada migração acrescenta redirecionamentos sobre o último, então URLs antigas passam por dois ou três saltos. Os rastreadores do Google seguem até 10 saltos de redirecionamento por padrão^[1], mas cada salto representa uma viagem completa de ida e volta para os visitantes.
• Responsabilidade. Quando os redirecionamentos ficam em um arquivo do servidor, apenas engenheiros podem alterá-los, e marketing ou SEO esperam por uma implantação.
• Auditoria. Ninguém se lembra de por que um redirecionamento existe, se ele ainda recebe tráfego ou quem o alterou por último.

As opções comparadas#

Os Bulk Redirects da Cloudflare permitem 10.000 redirecionamentos de URL em listas no plano Free, 25.000 no Pro, 50.000 no Business e 1.000.000 por padrão no Enterprise, por conta^[2]. As regras de Single Redirect são uma permissão separada, muito menor, por zona.

Exemplo de mapa do Nginx#

nginx# /etc/nginx/redirects.map  (uma linha por redirecionamento)
# /old-path  /new-path;

map $uri $redirect_to {
    default "";
    include /etc/nginx/redirects.map;
}

server {
    server_name www.example.com;
    if ($redirect_to) {
        return 301 $redirect_to;
    }
}

Exemplo de RewriteMap do Apache#

apache# Na configuração do host virtual, não em .htaccess
RewriteEngine On
RewriteMap redirects "dbm:/etc/apache2/redirects.map"
RewriteCond ${redirects:%{REQUEST_URI}} !=""
RewriteRule ^ ${redirects:%{REQUEST_URI}} [R=301,L]

# Compile o arquivo DBM a partir de um arquivo de texto de pares "antigo novo":
# httxt2dbm -i redirects.txt -o redirects.map

Qual escolher#

Manter saudável uma grande lista de redirecionamentos#

1. Achate as cadeias após cada migração. Aponte cada URL antiga diretamente para a URL final, e não para o redirecionamento anterior. Veja Corrigir cadeias e loops de redirecionamento.
2. Prefira correspondências exatas. Use regras de padrão para pastas inteiras que se moveram da mesma forma e entradas exatas para todo o resto. As consultas exatas continuam rápidas e são fáceis de ler.
3. Marque cada redirecionamento com o respectivo projeto. "Replataformação de 2024" ou "Campanha de primavera" diz à próxima pessoa por que ele existe.
4. Revise aqueles que ninguém visita. Mantenha redirecionamentos para páginas movidas por pelo menos um ano. Depois disso, analise os redirecionamentos sem visitas e sem links externos antes de removê-los; remover um redirecionamento que ainda tem links o transforma em um 404.
5. Registre quem alterou o quê. Histórico do Git para arquivos de mapa, ou histórico de alterações na sua ferramenta de redirecionamento. Isso transforma um redirecionamento quebrado de um mistério em uma correção de dois minutos.
6. Teste uma amostra após cada importação. Verifique 50 URLs antigas da lista: cada uma deve retornar um 301 para uma página que responde 200.

Como o RedirHub lida com listas grandes de redirecionamentos#

O RedirHub responde aos redirecionamentos a partir de 130 PoPs globais, então a pesquisa acontece na borda e seu próprio servidor não é envolvido. Para listas grandes:

• Importe de um CSV com uma revisão do que será adicionado, atualizado ou ignorado antes que qualquer coisa seja gravada. Reimportar uma exportação editada conta apenas novos links.
• Capacidade: o Core inclui 2.500 links gerenciados, o Pro 10.000 e o Enterprise é definido por contrato para operações em escala de milhões. Um redirecionamento de domínio inteiro não usa links gerenciados.
• No Pro, cada link mostra quem o alterou, quando e os valores antigos e novos, incluindo alterações de importações CSV e da API.
• Altere muitos destinos de uma vez com uma prévia, pelo painel ou pela API, ou mantenha a lista no Git com o provedor do Terraform.