# Como corrigir o 404 Monitor que não funciona no SEOPress

O SEOPress 404 Monitor não funciona quando o recurso de monitoramento de 404 está desativado, quando o site é SEOPress Free (a feature é exclusiva do PRO) ou quando o servidor ou um cache devolve o erro 404 antes do WordPress carregar e registrar a URL.

## O que é SEOPress 404 Monitor que não funciona?

O SEOPress 404 Monitor é o recurso do SEOPress PRO que registra automaticamente toda URL acessada no site que devolve um erro 404, montando uma lista de páginas quebradas que você pode transformar em redirecionamentos 301. Ele vive em SEO, PRO, na aba Redirections / 404, e só passa a gravar depois que a opção Enable 404 monitoring é marcada e as alterações são salvas. Quando ele não funciona, a lista de 404 fica permanentemente vazia mesmo com visitantes batendo em URLs inexistentes.

Na prática, o problema quase nunca é um bug do plugin: ou o monitoramento não foi ativado, ou o site usa a versão gratuita do SEOPress (que não inclui o 404 Monitor), ou a requisição 404 nunca chega ao WordPress porque o servidor web, um cache de página ou uma camada de CDN entrega o erro antes do PHP rodar. Como o registro depende do WordPress processar a requisição, qualquer coisa que sirva o 404 fora do WordPress deixa o monitor cego.

## Como identificar

- A aba SEO, PRO, Redirections / 404 mostra a lista de 404 sempre vazia, mesmo após dias de tráfego e visitas a URLs que não existem.
- A opção Enable 404 monitoring aparece desmarcada ou a seção Redirections / 404 não existe porque o site usa o SEOPress Free.
- URLs quebradas conhecidas (testadas no navegador e retornando a página de erro do tema) não surgem em nenhum momento no log de 404 do SEOPress.
- O contador de erros 404 trava num número antigo e não cresce, mesmo com novos acessos a páginas inexistentes.
- Você consegue criar redirecionamentos manuais em Redirections, mas nenhum 404 é capturado automaticamente para virar redirect.

**Antes de começar:** Antes de mexer em regras de cache, CDN ou em um mu-plugin de diagnóstico em produção, faça backup do site (arquivos e banco de dados) ou teste em um ambiente de staging, para poder reverter caso o comportamento do 404 mude de forma inesperada.

## Como prevenir

- Ative o Enable 404 monitoring logo na configuração inicial do SEOPress PRO e confirme que as alterações foram salvas, para o site começar a registrar 404 desde o primeiro dia.
- Habilite a opção Automatically delete 404 after 30 days para a tabela de 404 não crescer sem controle em sites com muito tráfego, conforme recomenda a documentação do SEOPress.
- Configure o cache e a CDN para nunca armazenar respostas com status 404, mantendo o WordPress como quem processa cada requisição quebrada.
- Revise periodicamente a lista de 404 e converta os erros recorrentes em redirecionamentos 301 pela aba Redirections, evitando perda de tráfego e link equity.

Erros relacionados

- [Como corrigir o redirecionamento 301 que não funciona no SEOPress](https://full.services/wp-fixer/corrigir-redirecionamento-301-seopress/)
- [Como corrigir o sitemap XML que não gera no SEOPress](https://full.services/wp-fixer/corrigir-sitemap-xml-seopress/)
- [Como corrigir o erro de schema markup no SEOPress](https://full.services/wp-fixer/corrigir-schema-markup-seopress/)

## Causa

- A opção Enable 404 monitoring nunca foi marcada em SEO, PRO, Redirections / 404, ou foi marcada sem clicar em Save changes, então o SEOPress nunca começa a gravar os 404.
- O site usa o SEOPress Free: o 404 Monitor é um recurso exclusivo do SEOPress PRO, e sem a licença PRO ativa a aba Redirections / 404 simplesmente não existe.
- Um plugin de cache de página (como WP Rocket ou W3 Total Cache) ou uma CDN serve uma resposta cacheada da URL antes do WordPress carregar, então o PHP do SEOPress nunca roda para registrar o 404.
- O servidor web (Apache via .htaccess ou Nginx) intercepta a requisição e devolve um 404 próprio do servidor antes de chamar o index.php do WordPress, deixando o monitor sem a requisição para registrar.
- A URL quebrada está dentro de um caminho listado no campo Exclude paths from 404 logging, fazendo o SEOPress ignorar de propósito aquele 404.
- A limpeza automática Automatically delete 404 after 30 days apagou registros antigos, dando a impressão de que o monitor não está capturando nada.

## Como resolver

1. Confirme que o site tem SEOPress PRO ativo: O 404 Monitor é exclusivo do SEOPress PRO. Verifique se a licença PRO está ativa, pois sem ela a aba Redirections / 404 nem aparece no menu e o monitoramento não existe na versão gratuita.

```
Painel WP -> SEO -> PRO -> Account (License)
Confirme que a licença SEOPress PRO está ativada e válida
```

2. Ative o Enable 404 monitoring e salve: Vá até a aba de redirecionamentos do PRO, marque a opção de monitoramento e salve. Sem salvar, o SEOPress não passa a gravar os 404 segundo a documentação oficial.

```
Painel WP -> SEO -> PRO -> Redirections / 404
Marque a opção 'Enable 404 monitoring'
Clique em 'Save changes'
```

3. Revise o campo Exclude paths from 404 logging: Ainda na aba Redirections / 404, confira se o caminho da URL quebrada que você espera ver não está na lista de exclusão. Caminhos listados ali são ignorados de propósito pelo monitor.

```
Painel WP -> SEO -> PRO -> Redirections / 404
Localize o campo 'Exclude paths from 404 logging'
Remova qualquer caminho que você quer que seja monitorado e salve
```

4. Faça o cache e a CDN não servirem o 404: Se um cache de página ou CDN entrega a resposta antes do WordPress, o PHP do SEOPress não roda e o 404 não é registrado. Garanta que respostas 404 não sejam cacheadas e limpe o cache antes de testar de novo.

```
Painel WP -> plugin de cache -> limpe todo o cache de página
No painel da CDN (ex.: Cloudflare) -> Purge Everything
Confirme nas regras do cache que respostas com status 404 não são armazenadas
```

5. Garanta que o WordPress processe o 404: Se o servidor devolve um 404 próprio antes do WordPress, o monitor fica cego. Acesse uma URL inexistente e confirme que ela cai na página de erro do tema (e não numa tela 404 genérica do Apache ou Nginx), o que prova que o index.php do WordPress está sendo chamado.

```
Abra no navegador uma URL claramente inexistente, ex.: https://seusite.com/teste-404-seopress
Confirme que aparece a página 404 do seu tema WordPress, não a tela padrão do servidor
Volte em SEO -> PRO -> Redirections / 404 e atualize a lista para ver o registro
```


## Código

```php
<?php
/*
 * Plugin Name: FULL - Diagnostico de 404 do WordPress
 * Description: Confirma se o WordPress esta processando a requisicao 404 antes do SEOPress registrar.
 */
add_action( 'template_redirect', 'full_log_404_para_diagnostico' );
function full_log_404_para_diagnostico() {
    if ( ! is_404() ) {
        return;
    }
    // Se esta linha aparece no debug.log, o WordPress recebeu o 404 e o SEOPress consegue registrar.
    error_log( 'FULL 404 diagnostico: WordPress processou ' . esc_url_raw( home_url( add_query_arg( array() ) ) ) );
}
```

## Perguntas frequentes

### Por que o 404 Monitor do SEOPress não registra nenhum erro

Na maioria dos casos a opção Enable 404 monitoring está desmarcada ou foi marcada sem salvar. Vá em SEO, PRO, Redirections / 404, marque a opção e clique em Save changes para o SEOPress começar a gravar os 404.

### O 404 Monitor existe no SEOPress gratuito

Não. O 404 Monitor é um recurso exclusivo do SEOPress PRO. No SEOPress Free a aba Redirections / 404 nem aparece, então é preciso ter a licença PRO ativa para monitorar e listar os erros 404 do site.

### Onde fica o 404 Monitor no painel do SEOPress

Ele fica em SEO, PRO, na aba Redirections / 404. É ali que você marca Enable 404 monitoring, define o campo Exclude paths from 404 logging e ativa a limpeza automática dos registros antigos.

### Por que minhas URLs quebradas não aparecem na lista de 404

Provavelmente um cache de página, uma CDN ou o próprio servidor está devolvendo o 404 antes do WordPress carregar, então o PHP do SEOPress nunca roda. Garanta que respostas 404 não sejam cacheadas e que a URL caia na página de erro do seu tema.

### O que faz a opção Automatically delete 404 after 30 days

Ela remove automaticamente os registros de 404 com mais de 30 dias, evitando que a tabela cresça demais em sites com muito tráfego. É recomendada pela documentação do SEOPress, mas pode dar a impressão de que o monitor parou se você esperava ver erros antigos.

### Como transformo um 404 registrado em redirecionamento

Com o monitoramento ativo, ative também o toggle Redirections na mesma aba: isso cria o tipo de conteúdo Redirections no menu lateral. Use os 404 registrados como referência e crie ali um redirect 301 para a URL correta.

### O campo Exclude paths from 404 logging pode estar bloqueando meus registros

Sim. Qualquer caminho listado em Exclude paths from 404 logging é ignorado de propósito pelo monitor. Abra a aba Redirections / 404 e remova da lista de exclusão o caminho que você quer acompanhar, depois salve.

**Fonte:** [SEOPress — Enable 301 redirections and 404 monitoring](https://www.seopress.org/support/guides/redirections/)