receita

Receita: redirecionamentos e links quebrados

Mapa de redirecionamentos 301 no servidor ou no WordPress e um verificador de links quebrados com WP-CLI.

resposta curtaQuando uma URL muda, redirecione-a com 301 para a página equivalente, de preferência no servidor ou com wp_safe_redirect em PHP, e mantenha um mapa único. Para links quebrados, verifique os links do conteúdo com wp_remote_head e corrija na origem. URL removida sem substituto deve responder 404 ou 410, não ser jogada na home.
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

  1. 01Monte o mapa antigo e novo e elimine cadeias e loops.
  2. 02Implemente os redirecionamentos no servidor (preferido) ou em PHP.
  3. 03Teste cada URL com curl.
  4. 04Rode a varredura de links quebrados e corrija na origem.
  5. 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.

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.

  1. curl -sI https://seusite.com.br/guia-antigo/ deve mostrar HTTP/2 301 e location: com a nova URL.
  2. curl -sIL -o /dev/null -w "%{num_redirects} %{url_effective}\n" https://seusite.com.br/guia-antigo/ deve mostrar 1 salto.
  3. Teste uma URL inexistente e sem mapa: deve dar 404 com página de erro útil.
  4. Rode a varredura e confira os números.
  5. No Search Console, acompanhe o relatório de indexação de páginas e os erros 404.

Erros comuns e como desfazer

ErroEfeitoCorreção
Loop A para B para Aerro de redirecionamentodetecte no teste com curl -L
Cadeia de três saltoslentidão e perda de clarezaaponte direto ao destino final
Tudo para a homeexperiência ruim404 ou 410 quando não há equivalente
302 em mudança definitivaGoogle mantém a URL antigause 301
Mapa sem barra finalregra não casanormalize 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

  1. Redirects and Google Search, Google Search Central (2026-04-14)
  2. HTTP status codes, and network and DNS errors, Google Search Central (2026-02-04)
  3. wp_safe_redirect(), WordPress Developer Resources (2026-10-14)
  4. wp_remote_head(), WordPress Developer Resources (2026-10-14)
  5. 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.