Redirecionamentos 301 no Cloudflare Pages: como não perder visitas ao mudar URLs

Você renomeia a página de serviços do seu site para deixá-la mais clara. No dia seguinte, um cliente escreve pelo WhatsApp: “Aparece um erro 404 no link que você me mandou”. Esse link continua nos seus anúncios, no seu perfil do Google e no e-mail de boas-vindas.

Mudar uma URL sem avisar é perder visitas que você já conquistou ou pagou. A solução cabe em uma linha de texto.

O que é um redirecionamento 301 e por que ele importa?

É uma instrução do servidor que envia quem pedir um endereço antigo para o novo e avisa que a mudança é permanente. Segundo a documentação do Google Search Central, o Googlebot segue um redirecionamento permanente e o processo de indexação o toma como sinal de que o destino deve ser a URL canônica. Com um temporário, o Google também o segue, mas não trata o destino como canônico.

Por isso o 301 é indicado quando a mudança é definitiva: você renomeou uma página, uniu duas ou trocou de domínio. Se você vem de outra hospedagem, veja o guia para migrar do WordPress para o Cloudflare Pages sem perder SEO.

Como criar redirecionamentos no Cloudflare Pages?

Com um arquivo de texto chamado _redirects, sem extensão, colocado no diretório de arquivos estáticos do projeto. A documentação da Cloudflare indica que, se você usa um framework como o Astro, ele fica em public/. Cada linha segue este formato: origem, destino e, opcionalmente, o código.

# Una página renombrada
/servicios-antiguos /servicios/ 301

# Una sección completa
/promo/* /ofertas/:splat 301

As linhas que começam com # são comentários, e as que não seguem o formato são ignoradas. O arquivo não é exibido ao público como mais um recurso.

Qual é a diferença entre os códigos de status?

O Cloudflare Pages aceita cinco códigos, e o que você usar define como o Google o interpreta. Se você omitir o código, o padrão é 302.

Código	Tipo	Quando usar
301	Permanente	Página renomeada, movida ou unida a outra
308	Permanente	Alternativa permanente ao 301
302	Temporário	Mudança curta, como manutenção (é o padrão)
303	Temporário	Mudanças que não devem ser tomadas como definitivas
307	Temporário	Alternativa temporária ao 302

Erro comum: escrever /viejo /nuevo sem o 301. A Cloudflare aplica 302 por padrão, e o Google não o toma como mudança definitiva. Sua URL nova pode demorar mais para ocupar o lugar da antiga nos resultados.

Como redirecionar muitas páginas de uma vez?

Com um asterisco (splat) para caminhos inteiros ou com marcadores de posição para partes específicas da URL. Segundo a Cloudflare, você só pode usar um splat por URL, que captura todos os caracteres e é reutilizado no destino como :splat. Os marcadores são escritos como :nome, correspondem a tudo menos a barra e cada nome só pode ser referenciado uma vez no destino.

Uma boa prática é mapear uma a uma as páginas com tráfego ou links de entrada e deixar o splat para seções inteiras. Antes de lançar, veja no Search Console quais URLs recebiam visitas, como explicamos no guia de Search Console e sitemap.

Quais limites e regras de prioridade o _redirects tem?

Ele aceita 2.000 redirecionamentos estáticos e 100 dinâmicos, para um total de 2.100, e cada linha pode ter até 1.000 caracteres. Se você precisar de mais, a Cloudflare recomenda seus Bulk Redirects. Estas regras evitam surpresas:

• Para uma mesma origem, vale a regra que estiver mais acima. Escreva os estáticos antes dos dinâmicos.
• Um redirecionamento sempre é seguido, mesmo que exista um arquivo nesse caminho.
• Os redirecionamentos são executados antes do arquivo _headers. Explicamos isso no guia do arquivo _headers.
• Não há correspondência por parâmetros de consulta, nem por país, idioma ou cookie, nem redirecionamentos em nível de domínio.
• Eles não se aplicam a requisições atendidas por Pages Functions.

Atenção: o redirecionamento prevalece até sobre um arquivo real. Se você deixar uma regra antiga e depois criar uma página nesse caminho, ninguém verá a página nova.

Como verifico que funciona?

Abra o endereço antigo no navegador e confirme que ele chega ao novo; depois veja o código de status na aba Rede. Teste também os caminhos com splat e uma regra de cada tipo. Se o seu domínio passa pela Cloudflare, revise também o guia de SSL/TLS.

Os redirecionamentos do lado do servidor são os que o Google interpreta com mais confiabilidade. Os de JavaScript ficam como último recurso, porque, se a renderização falhar, o Google pode não vê-los.

Em resumo

Aquele link quebrado nos seus anúncios e no seu perfil do Google se resolve com uma linha. Escreva sempre o código 301 em mudanças definitivas, ordene suas regras e teste antes de lançar. Se você quiser que deixemos tudo configurado e testado no seu site, conheça nosso serviço de hospedagem e domínios.