Receita: redirecionamentos e links quebrados
Mapa de redirecionamentos 301 no servidor ou no WordPress e um verificador de links quebrados com WP-CLI.
Neste texto
Que problema esta receita resolve?
Todo site muda URLs: troca de slug, migração, fusão de artigos. Quem tinha o endereço antigo (leitores, outros sites, mecanismos de busca) cai numa página de erro. E no sentido inverso, o seu conteúdo acumula links de saída que deixaram de funcionar. As duas falhas custam confiança e deixam sinais ruins. A receita resolve com um mapa de redirecionamentos organizado e uma varredura periódica de links.
A lógica vem de plugins de gerenciamento de redirecionamentos e de verificação de links quebrados que Camillo Dantas desenvolveu. Eles não são vendidos. O método e o código estão aqui.
O que o Google diz sobre redirecionamentos
A documentação do Google (atualizada em 14 de abril de 2026) recomenda redirecionamento permanente do lado do servidor sempre que possível. Redirecionamentos permanentes (301, 308) fazem o Google tratar o destino como a URL canônica; os temporários (302, 303, 307) mantêm a origem como a exibida. JavaScript só quando as alternativas do servidor forem impossíveis. A documentação não fixa um prazo mínimo para manter os redirecionamentos; mantenha enquanto houver tráfego ou links apontando para a URL antiga.
Sobre erros: segundo a documentação do Google sobre erros HTTP (atualizada em 4 de fevereiro de 2026), um 404 e um 410 são tratados do mesmo modo, como indicação de que o conteúdo não existe, e o Google reduz o rastreamento dessas URLs. Já uma página que responde 200, mas parece erro, é um soft 404.
Quando usar e quando não usar
Use 301 quando existe uma página equivalente: o mesmo assunto, em outra URL.
Não use:
- para mandar toda URL removida à home. Para o leitor, é um destino sem relação com o que ele procurava; se a página não tem equivalente, devolva 404 ou 410 com uma página de erro útil (busca e links de saída);
- redirecionamento temporário (302) para uma mudança definitiva;
- cadeias longas: A para B para C. Aponte A direto para C.
Pré-requisitos
- Lista de URLs antigas e novas (planilha com duas colunas).
- Acesso ao servidor ou a um mu-plugin.
- WP-CLI para a varredura.
- Nível: intermediário.
Passo a passo
- 01Monte o mapa antigo e novo e elimine cadeias e loops.
- 02Implemente os redirecionamentos no servidor (preferido) ou em PHP.
- 03Teste cada URL com curl.
- 04Rode a varredura de links quebrados e corrija na origem.
- 05Reveja o relatório de cobertura do Search Console.
Opção 1: Apache (.htaccess)
Para poucas regras pontuais, a diretiva Redirect do módulo mod_alias basta. Coloque antes do bloco do WordPress:
Redirect 301 /guia-antigo/ https://seusite.com.br/guia-novo/
RedirectMatch 301 ^/blog/(\d{4})/(.*)$ https://seusite.com.br/$2
A segunda linha remove um prefixo de data das URLs antigas. Teste com cuidado: uma expressão regular ampla demais redireciona páginas que não deviam.
Opção 2: PHP no WordPress
Quando o mapa vem de uma lista que muda, use o gancho template_redirect. A função wp_safe_redirect() aceita o status como segundo parâmetro (padrão 302) e não encerra a execução, então é preciso chamar exit. Ela só redireciona para hosts permitidos; para outro domínio, o host precisa estar no filtro allowed_redirect_hosts.
<?php
/**
* Plugin Name: Redirecionamentos 301 (receita)
*/
function rd_mapa() {
return array(
'/guia-antigo/' => '/guia-novo/',
'/promo-2023/' => '/ofertas/',
);
}
add_action( 'template_redirect', function () {
if ( ! is_404() ) {
return; // só age quando o WordPress não achou a página.
}
$caminho = wp_parse_url( isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( $_SERVER['REQUEST_URI'] ) : '', PHP_URL_PATH );
$caminho = trailingslashit( (string) $caminho );
$mapa = rd_mapa();
if ( isset( $mapa[ $caminho ] ) ) {
if ( wp_safe_redirect( home_url( $mapa[ $caminho ] ), 301 ) ) {
exit;
}
}
} );
Vantagem: o mapa fica versionado em código. Limite: o PHP só roda depois que o servidor chamou o WordPress; para milhares de regras, o servidor é mais rápido.
Para o caso comum de mudança de slug de um post, o WordPress já cria o redirecionamento sozinho ao reconhecer o slug antigo (_wp_old_slug), então só é preciso mapear mudanças de estrutura maiores.
Passo 4: varredura de links quebrados
Script para wp eval-file verificar-links.php. Ele extrai links de saída dos posts publicados e confere o status com wp_remote_head():
<?php
$ids = get_posts( array( 'post_type' => 'post', 'post_status' => 'publish', 'numberposts' => 200, 'fields' => 'ids' ) );
$feito = array();
foreach ( $ids as $id ) {
$html = get_post_field( 'post_content', $id );
if ( ! preg_match_all( '/<a\s[^>]*href=["\'](https?:\/\/[^"\']+)["\']/i', $html, $m ) ) {
continue;
}
foreach ( array_unique( $m[1] ) as $url ) {
if ( isset( $feito[ $url ] ) ) {
continue;
}
$resp = wp_remote_head( $url, array( 'timeout' => 8, 'redirection' => 3 ) );
$cod = is_wp_error( $resp ) ? 'ERRO' : wp_remote_retrieve_response_code( $resp );
$feito[ $url ] = $cod;
if ( 'ERRO' === $cod || (int) $cod >= 400 ) {
WP_CLI::line( $id . "\t" . $cod . "\t" . $url );
}
usleep( 300000 ); // pausa de 0,3 s para não sobrecarregar os destinos.
}
}
Notas: alguns servidores rejeitam HEAD (retornam 405); para esses, repita com wp_remote_get. Processe em lotes de 200 posts para não estourar o tempo. Corrija o link na origem: aponte para a nova URL, troque por outra fonte ou remova o trecho. Se o destino é um artigo que deixou de existir, procure uma cópia em arquivo web antes de remover.
Como testar
Critério de sucesso: cada URL antiga responde 301 com cabeçalho Location para o destino correto em um único salto; a varredura devolve lista vazia ou só links aceitos.
curl -sI https://seusite.com.br/guia-antigo/deve mostrarHTTP/2 301elocation:com a nova URL.curl -sIL -o /dev/null -w "%{num_redirects} %{url_effective}\n" https://seusite.com.br/guia-antigo/deve mostrar 1 salto.- Teste uma URL inexistente e sem mapa: deve dar 404 com página de erro útil.
- Rode a varredura e confira os números.
- No Search Console, acompanhe o relatório de indexação de páginas e os erros 404.
Erros comuns e como desfazer
| Erro | Efeito | Correção |
|---|---|---|
| Loop A para B para A | erro de redirecionamento | detecte no teste com curl -L |
| Cadeia de três saltos | lentidão e perda de clareza | aponte direto ao destino final |
| Tudo para a home | experiência ruim | 404 ou 410 quando não há equivalente |
| 302 em mudança definitiva | Google mantém a URL antiga | use 301 |
| Mapa sem barra final | regra não casa | normalize com trailingslashit |
Para desfazer, remova a regra do mapa e a URL volta ao comportamento anterior (404 ou conteúdo original). Redirecionamentos em cache do navegador podem demorar a sumir; teste em janela anônima.
Checklist final
- Mapa em planilha, sem cadeias e loops.
- 301 no servidor sempre que possível.
- Cada regra testada com curl.
- 404 ou 410 para o que não tem substituto.
- Varredura de links de saída mensal.
- Sitemap com apenas URLs finais.
Para seguir
Depois de redirecionar, confira o sitemap e a indexação. Links perdidos de outros sites podem ser recuperados com a receita de backlinks perdidos. O mini-curso Auditoria de SEO na prática e a trilha de SEO técnico tratam o assunto em profundidade. Plugins de origem: camillodantas.com.br/plugins.
Fontes
- Redirects and Google Search, Google Search Central (2026-04-14)
- HTTP status codes, and network and DNS errors, Google Search Central (2026-02-04)
- wp_safe_redirect(), WordPress Developer Resources (2026-10-14)
- wp_remote_head(), WordPress Developer Resources (2026-10-14)
- mod_alias, Apache HTTP Server Documentation (2026-10-14)
Não sabe por onde começar?
Compare as opções e escolha a trilha pelo seu objetivo.