WordPress: Como corrigir o erro de página não encontrada (404)

Apesar de ser o Sistema Gerenciador de Conteúdo mais utilizado e ser praticamente uma unanimidade entre os desenvolvedores, o WordPress apresenta algumas dificuldades de configuração que podem tornar todo o seu site inacessível. Um dos erros mais comuns ao se utilizar a plataforma, é quando os posts/páginas apresentam problemas nos links, de forma que qualquer acesso leve ao erro de página não encontrada.

ATUALIZAR OS LINKS PERMANENTES

Os links permanentes são a forma que o WordPress gerencia o caminho dos posts. Geralmente, utiliza-se o nome do post como referência para link permanente, uma vez que o caminho fica mais amigável. A primeira abordagem consiste basicamente em acessar a configuração de links permanentes (Configurações >> Links Permanentes) e clicar no botão de salvar (não é necessário fazer nenhuma alteração).

Esse procedimento atualiza seus links permanentes e na maior parte dos casos corrige o erro. Entretanto, dependendo das permissões de acesso no seu servidor, pode ser necessário modificar seu arquivo .htaccess (que controla os acessos do servidor Apache). No seu servidor, o arquivo .htaccess se encontra na raiz da sua aplicação WordPress (onde também se localizam as pastas wp-content, wp-includes, etc.). Você tem duas opções: a primeira é atualizar as permissões do arquivo e realizar o procedimento anterior:

Ou você pode alterar o arquivo manualmente para inserir o conteúdo que o WordPress estaria tentando inserir quando você clica no botão de salvar:

Esta é a solução trivial que soluciona a maior parte dos casos. Entretanto, pode ser necessário alterar configurações no apache que podem estar bloqueando a reescrita do arquivo.

HABILITAR MOD_REWRITE NO APACHE

Em alguns casos, o módulo de reescrita do apache precisa ser habilitado para atualização do arquivo. É possível habilitar esse módulo através do comando:

Após o comando, é necessário reiniciar o servidor:

Após reiniciar o servidor, o procedimento de salvar a configuração dos links permanentes é refeito. No meu caso, me deparei com um problema em que estes dois passos ainda não foram suficientes para solução do problema, sendo necessária uma alteração no arquivo de configuração do apache, explicada na próxima etapa.

ATUALIZANDO O ARQUIVO DE CONFIGURAÇÃO DO APACHE

O arquivo de configuração do apache está localizado em “/etc/apache2/apache2.conf” para a versão mais recente do servidor em uma máquina Ubuntu. No meu caso, foi necessário incluir uma configuração para o meu diretório do WordPress que permitia a sobrescrita (AllowOverride). Supondo que minha aplicação estivesse em “/home/ronanlopes/ronanlopes”, por exemplo, seria necessário incluir o seguinte trecho no arquivo de configuração:

Novamente é necessário o reinício do servidor, e em seguida acessar a seção de links permanentes no WordPress e salvar a configuração. No meu caso, este último procedimento foi o responsável definitivo pela solução do problema. Qualquer dúvida ou problema nos procedimentos utilize os comentários ou entre em contato!