Tela branca WordPress: Top 10 erros e soluções

O WordPress é um dos sistemas de ge­ren­ci­a­mento de conteúdo (CMS) mais con­fiá­veis do mercado, além de ser o mais popular deles. En­tre­tanto, mesmo que seus de­sen­vol­ve­do­res continuem a aprimorá-lo, usuários deparam-se com erros, de tempos em tempos. Alguns destes erros podem causar a temida tela branca do WordPress. Nosso top 10 erros e soluções ensina você a consertar uma página em branco no WordPress e a resolver outros problemas comuns da pla­ta­forma.

1. Tela branca da morte: Site WordPress em branco

Muitos usuários do WordPress já se es­bar­ra­ram neste erro de exibição. Quando, sem motivo aparente, ope­ra­do­res deparam-se com uma página em branco no WordPress, esses referem-se a ela como “tela branca da morte” (white screen of death). Ma­ri­nhei­ros de primeira viagem costumam ficar as­sus­ta­dos com seu WordPress em branco, por ima­gi­na­rem que perderam todo o conteúdo. Isso, contudo, não acontece. A tela branca do WordPress é uma falha comum, que pode ser ra­pi­da­mente corrigida.

Várias situações podem levar à tela branca da morte: plugins cor­rom­pi­dos ou in­com­pa­tí­veis, problemas no PHP, erros de co­di­fi­ca­ção e falhas no banco de dados. Acon­se­lha­mos, portanto, que você tente descobrir o que está deixando o seu site WordPress em branco antes de partir para uma solução. Ao ser corrigido, o problema cessará e o seu site voltará ao ar.

Para exibir esse vídeo pre­ci­sa­mos usar cookies de terceiros. Você pode acessar e mudar suas con­fi­gu­ra­ções de cookies here.

Se você é um usuário avançado, que sabe como usar um cliente FTP, ative o WP_DEBUG para descobrir a causa do seu site WordPress em branco. Quando ativo, o modo debug do WordPress emite mensagens de erro ex­pli­ca­ti­vas, que mostram porque um site não está fun­ci­o­nando cor­re­ta­mente. Baseie-se nas mensagens recebidas para desvendar o problema. Se você é um usuário iniciante ou in­ter­me­diá­rio, não se preocupe! Existem outras maneiras de lidar com a tela branca do WordPress, e essas também serão ex­plo­ra­das por este artigo.

Plugins WordPress costumam ser os prin­ci­pais res­pon­sá­veis pela tela branca da morte.

Close

Causa 1: Tela branca WordPress gerada por plugin

Se há algo de bom a dizer sobre a tela branca da morte, é que seu nome é bem mais dramático do que o problema em si. Na maioria das vezes, bastará que você desative o plugin cor­rom­pido ou in­com­pa­tí­vel para que o seu site volte a ser exibido cor­re­ta­mente. A tela branca do WordPress ge­ral­mente é causada por:

• Ativação de um plugin que contém erro.
• Alteração de um plugin ativo.
• Alteração do código de um plugin ativo no back-end.

Se você tiver realizado uma dessas três al­te­ra­ções há pouco tempo, acesse seus plugins no Painel e desative o que foi recém-instalado ou mo­di­fi­cado. Em muitos casos, essa ação já resolverá o problema. Depois que você desativar o plugin que está causando o erro, seu site deverá ser res­tau­rado. Caso você pretenda continuar usando o plugin com o código mo­di­fi­cado que está causando o erro, proceda desta forma:

Exclua o plugin mo­di­fi­cado do seu WordPress e refaça download da versão original.

Close

Algumas vezes, contudo, não é possível desativar o plugin pro­ble­má­tico da forma descrita acima. Isso ocorre quando o erro afeta, também, o Painel do WordPress. Se for este o caso, você terá de usar um cliente FTP (file transfer protocol) para conseguir acessar os arquivos do WordPress e excluir ou desativar o plugin cor­rom­pido. Caso nunca tenha mexido com um cliente FTP para fazer al­te­ra­ções na sua ins­ta­la­ção WordPress, não se desespere: o apren­di­zado é fácil e muitas fer­ra­men­tas são gratuitas.

Depois de instalar o cliente FTP de sua pre­fe­rên­cia, faça login no seu domínio com as cre­den­ci­ais dis­po­ni­bi­li­za­das pelo seu provedor de hos­pe­da­gem. Em seguida, realize os passos descritos abaixo para apagar o plugin cor­rom­pido e consertar a tela em branco do WordPress:

• Navegue até o diretório onde os arquivos do seu WordPress estão ar­ma­ze­na­dos.
• Abra a pasta wp-content.
• Em wp-content, encontre a subpasta plugins e abra-a.
• Lá, localize o plugin recém-instalado ou mo­di­fi­cado, provável causa do WordPress em branco.
• Exclua o plugin (talvez seja ne­ces­sá­rio que você selecione o plugin e clique nele com o botão direito do mouse para encontrar a opção que o apagará da sua ins­ta­la­ção WordPress). Caso você não deseje excluir o plugin, basta renomear a pasta onde ele se encontra. Isso também o de­sa­ti­vará.
• Abra o seu navegador e tente acessar o seu site. Ide­al­mente, a tela branca da morte deverá ter de­sa­pa­re­cido, pos­si­bi­li­tando o seu login.

Re­co­men­da­mos que você faça uso de plugins ofe­re­ci­dos por fontes con­fiá­veis e que dis­po­ni­bi­li­zam algum tipo de suporte. Ainda, cer­ti­fi­que-se de que os plugins es­co­lhi­dos são com­pa­tí­veis com a sua versão do WordPress. Plugins de­sa­tu­a­li­za­dos têm mais chances de causar problemas.

Causa 2: Tela branca WordPress gerada por mo­di­fi­ca­ção no código

Se sua página em branco no WordPress não estiver sendo causada por um plugin, o erro pode estar re­la­ci­o­nado a possíveis mo­di­fi­ca­ções feitas por você, pelo editor de temas do WordPress, no arquivo functions.php ou em outro arquivo PHP. Se for este o caso, a seguinte mensagem de erro aparecerá na tela em branco:

Parse error: Syntax error, unexpected $ end in /home/name/public_html/wordpress/wp-content/themes/your_theme/functions.php on line 231

A in­for­ma­ção sinaliza que a tela branca do WordPress está sendo causada por um erro de código no tema WordPress con­fi­gu­rado. Para consertá-lo, basta restaurar o arquivo ao seu estado original.

Realizar a res­tau­ra­ção é fácil. Difícil é conseguir acessar o res­pec­tivo arquivo com rapidez, uma vez que você estará diante do WordPress em branco, sem acesso ao editor de temas. O modo mais rápido de contornar a situação é baixar novamente o arquivo cor­rom­pido na pasta do WordPress e substituí-lo, com a ajuda de um cliente FTP.

Depois de fazer login no servidor, proceda da seguinte forma:

• Navegue até o diretório onde estão lo­ca­li­za­dos os arquivos do WordPress.
• Abra a pasta wp-content e encontre a subpasta que armazena os temas.
• Abra a subpasta de temas e localize a que cor­res­ponde ao seu tema WordPress atual.
• Dentro da pasta do seu tema atual, procure pelo arquivo functions.php.
• Faça upload de uma versão funcional do functions.php. Ela pode ser a cópia do arquivo que você salvou no disco rígido antes de modificá-lo. Al­ter­na­ti­va­mente, use a versão original do seu tema.
• Caso você não queira subs­ti­tuir o arquivo, proceda da seguinte forma: renomeie a pasta do tema atual para desativá-lo e au­to­ma­ti­ca­mente habilitar o tema padrão do WordPress. Com o tema inativo, remova ma­nu­al­mente o código cor­rom­pido do res­pec­tivo arquivo functions.php.
• Caso você opte por subs­ti­tuir o arquivo que não funciona por outra versão, responda afir­ma­ti­va­mente ao seu cliente FTP quando ele lhe fizer essa pergunta.
• Abra o seu navegador e tente acessar o seu site. Ide­al­mente, a tela branca da morte deverá ter de­sa­pa­re­cido, pos­si­bi­li­tando o seu login.

Você também pode usar um tema diferente como teste ao invés de alterar o arquivo functions.php. Dessa forma, você con­se­guirá modificar o seu tema sem precisar alterar o código.

Vale a pena fazer uma cópia de segurança do seu tema WordPress antes de enveredar em qualquer tipo de alteração no código. O backup garantirá que o seu site será ra­pi­da­mente res­tau­rado, caso a mo­di­fi­ca­ção leve à tela branca da morte.

Causa 3: Tela branca WordPress sem motivo aparente

Às vezes, a página em branco do WordPress ocorre por motivo inex­pli­cá­vel. Ou seja, ela aparece mesmo quando você não modificou plugins nem o código do tema. Ao acessar o seu site e se deparar com a tela branca da morte sem causa aparente, você terá de fazer um debug.

Como em outros casos, o WP_DEBUG pode ajudar, uma vez que suas mensagens de erro facilitam a iden­ti­fi­ca­ção de arquivos de­fei­tu­o­sos. Depois de realizar um debug, sim­ples­mente remova, altere ou substitua os arquivos apontados. Seu site con­ti­nu­ará to­tal­mente funcional.

Você também pode tentar enfrentar a tela branca do WordPress sem fazer debug. Devido à com­ple­xi­dade de alguns plugins WordPress, existe a chance de o WP_DEBUG detectar um erro que, na verdade, não existe de fato. Ele pode se tratar somente de uma de­sa­tu­a­li­za­ção ou de uma in­com­pa­ti­bi­li­dade com o seu back-end. Neste caso, você deverá desativar todos os plugins ativos e reativá-los um a um até encontrar o que vem causando o problema.

Faça login no servidor do seu site com a ajuda de um cliente FTP e passe pelas etapas abaixo, para iden­ti­fi­car o plugin cor­rom­pido:

• Navegue até o diretório onde estão lo­ca­li­za­dos os arquivos do WordPress.
• Abra a pasta wp-content.
• Em wp-content, encontre a subpasta plugins e a renomeie. A ação de­sa­ti­vará todos os plugins em uso au­to­ma­ti­ca­mente. Escolha qualquer nome para a pasta de plugins, desde que você consiga reconhecê-lo em outros momentos.
• Tente acessar o Painel do WordPress. Se ele não estiver mais em branco e permitir que você faça o login, saberá que um dos plugins causou o erro.
• Volte à pasta onde os seus plugins WordPress ficam lo­ca­li­za­dos e volte a nomeá-la como plugins. A partir de então, todos os plugins voltarão a ser con­si­de­ra­dos pelo CMS, mas estarão de­sa­ti­va­dos. Reative-os um a um. Caso, em algum momento, a tela branca do WordPress volte a aparecer, você des­co­brirá o plugin culpado.
• Pelo cliente FTP de sua pre­fe­rên­cia, exclua o plugin pro­ble­má­tico.

Se o seu site WordPress per­ma­ne­cer em branco após todas essas etapas, o problema pode estar em algum tema instalado. Neste caso, execute o pro­ce­di­mento descrito acima na sua pasta de temas: mude o nome, a renomeie e reative cada tema, um a um, até a tela branca re­a­pa­re­cer, si­na­li­zando o erro.

Além das acima citadas, é claro que a tela branca do WordPress pode ser causada por outras razões, estas menos óbvias:

• Cache: Talvez você esteja usando um plugin de cache para melhorar o tempo de car­re­ga­mento do seu site. Se for este o caso, tente limpar o cache do WordPress. Caso não seja possível fazê-lo pela im­pos­si­bi­li­dade de acesso ao Painel, comece limpando o cache do seu navegador.
• Arquivo(s) cor­rom­pido(s): Algum arquivo do seu WordPress pode estar cor­rom­pido (por exemplo, devido a um malware). Entre em contato com o seu provedor de hos­pe­da­gem e solicite um di­ag­nós­tico.
• Servidor inativo: Verifique a caixa de entrada do seu e-mail. Muitos pro­ve­do­res de hos­pe­da­gem notificam seus clientes quando os ser­vi­do­res saem do ar. Caso você não tenha recebido nenhuma mensagem do tipo, entre em contato com o aten­di­mento ao cliente. Pode ser que o seu host esteja en­fren­tando algum problema ainda não detectado.

Em último caso, para corrigir a tela branca do WordPress, realize uma res­tau­ra­ção completa, possível a partir de um backup WordPress.

2. Erro interno do servidor (HTTP error 500)

A mensagem de erro HTTP 500 internal server error afeta ope­ra­do­res de todos os sites e não apenas do WordPress. Fe­liz­mente, na maioria dos casos, sua causa pode ser ra­pi­da­mente en­con­trada. Es­pe­ci­fi­ca­mente no WordPress, plugins e temas cor­rom­pi­dos podem causar erros no servidor. Outras possíveis causas de erros internos no servidor podem ser arquivos .htaccess cor­rom­pi­dos ou in­su­fi­ci­ên­cia de memória do PHP. Um internal server error pode afetar a página de ad­mi­nis­tra­ção do WordPress, mesmo que o restante do site continue fun­ci­o­nando nor­mal­mente.

Causa 1: Arquivo .htaccess cor­rom­pido

Arquivos .htaccess cor­rom­pi­dos são a causa mais comum da mensagem de erro HTTP 500 internal server error. Por esse motivo, comece sempre ve­ri­fi­cando este tipo de arquivo. Para tanto, faça login no servidor, por acesso FTP. Navegue até o diretório raiz do WordPress e procure pelo arquivo .htaccess. Tem­po­ra­ri­a­mente, renomeie este arquivo e, em seguida, re­car­re­gue o seu site. Se ele voltar funcionar, ótimo! Navegue até as con­fi­gu­ra­ções de per­ma­links no Painel do WordPress, crie um novo arquivo .htaccess no local e salve as mo­di­fi­ca­ções.

Causa 2: Memória do PHP in­su­fi­ci­ente

Uma memória do PHP limitada também pode causar um HTTP 500 internal server error. Para provar essa hipótese, você deverá verificar o error_log do seu site. Ative o WP_DEBUG para conferir os registros de erros, abrindo o arquivo wp-config.php e pro­cu­rando pela seguinte linha de código:

Close

Define ('WP_DEBUG', false);

Modifique o comando, deixando-o assim:

Define ('WP_DEBUG', true);

Caso essa não seja a causa do erro, re­co­men­da­mos que você desative plugins e temas um a um, pois erros internos do servidor também podem ser causados por plugins e temas de­fei­tu­o­sos. Al­ter­na­ti­va­mente, aumente o limite da memória do PHP e confira se a ação so­lu­ci­o­nou o erro.

Para exibir esse vídeo pre­ci­sa­mos usar cookies de terceiros. Você pode acessar e mudar suas con­fi­gu­ra­ções de cookies here.

Causa 3: Arquivo principal cor­rom­pido

Não é comum que falhas no arquivo principal do WordPress causem um erro interno do servidor, contudo, oca­si­o­nal­mente isso pode acontecer. Neste caso, você deverá fazer upload de um novo conjunto de arquivos prin­ci­pais para eliminar a origem do erro.

Logo depois de fazer login no seu site por FTP, crie novas pastas wp-admin e wp-includes — al­te­ra­ções nestas não deverão afetar as con­fi­gu­ra­ções de per­so­na­li­za­ção do seu WordPress, a não ser que você tenha ar­ma­ze­nado arquivos mo­di­fi­ca­dos nesses locais, o que ge­ral­mente não ocorre. Arquivos na pasta wp-content armazenam seu tema, seus plugins e outras per­so­na­li­za­ções. Não modifique essa pasta para que seu conteúdo não seja excluído do seu site.

Se tudo der errado, você precisará fazer o download de uma nova cópia do WordPress no site oficial do CMS e reinstalá-lo por completo.

3. Erro de conexão com o banco de dados

Se você for um usuário WordPress ex­pe­ri­ente, con­se­guirá corrigir este erro com rapidez. Contudo, prin­ci­pi­an­tes podem ter di­fi­cul­dade em com­pre­en­der o teor da mensagem error es­ta­blishing a database con­nec­tion.

O erro pode ocorrer, por exemplo, se você instalar o WordPress ma­nu­al­mente ou ao tentar fazer upload do seu próprio site. Ob­vi­a­mente, um bom provedor de hos­pe­da­gem para sites WordPress se ocupará de es­ta­be­le­cer con­fi­gu­ra­ções que garantam que a falha não chegue a acontecer. En­tre­tanto, quem instala e gerencia o WordPress por conta própria pode vir a se deparar com ela.

De todos os arquivos PHP do WordPress, o wp-config.php é o mais im­por­tante, pois, sem ele, a conexão com o banco de dados não pode ser es­ta­be­le­cida, o que fará o seu site deixar de funcionar. É no wp-config.php que você definirá suas con­fi­gu­ra­ções de conexão, como o nome do banco de dados, do usuário, a senha e o provedor. Como este arquivo não pode ser editado por pro­ve­do­res, é altamente im­pro­vá­vel que o cenário descrito abaixo seja gerado por um serviço pago de hos­pe­da­gem.

Para exibir esse vídeo pre­ci­sa­mos usar cookies de terceiros. Você pode acessar e mudar suas con­fi­gu­ra­ções de cookies here.

Causa 1: Con­fi­gu­ra­ções de conexão in­cor­re­tas

Caso um erro ocorra durante o es­ta­be­le­ci­mento da conexão com o banco de dados, este pro­va­vel­mente terá sido causado por dados in­cor­re­ta­mente inseridos no wp-config.php. Se você estiver migrando o seu site entre empresas de hos­pe­da­gem, terá de alterar o arquivo de con­fi­gu­ra­ção do WordPress. Atualize o nome do banco de dados, o nome de usuário e a res­pec­tiva senha no wp-config.php, para que o banco de dados volte a se tornar acessível.

Close

Causa 2: Falha ao migrar site WordPress de provedor

Outro erro comum pode estar re­la­ci­o­nado à trans­fe­rên­cia dos arquivos do WordPress para um novo provedor de hos­pe­da­gem. Num primeiro momento, seu site con­ti­nu­ará a ser exibido quando você acessar o URL. No entanto, assim que seu antigo provedor de hos­pe­da­gem cancelar o seu contrato, seu site não será mais exibido, caso você ainda não tenha movido o banco de dados para o servidor do novo provedor. Neste caso, você também receberá a mensagem de erro error es­ta­blishing a database con­nec­tion.

A melhor maneira de combater esse erro é evitar que ele ocorra. Assim, logo que fechar um novo contrato, transfira ime­di­a­ta­mente todo o banco de dados para o novo provedor de hos­pe­da­gem e atualize o arquivo wp-config.php, para que ele consiga acessá-lo. Dessa forma, ao ser cancelado, seu antigo contrato de hos­pe­da­gem não resultará em perda de dados e em temidas mensagens de erro.

Antes de iniciar o processo, cer­ti­fi­que-se de ter uma cópia de segurança do banco de dados do seu wordPress, ex­por­tando o arquivo SQL.

Causa 3: Arquivo wp-config.php de­fei­tu­oso

Erros podem ocorrer se você se esquecer de atualizar o arquivo wp-config.php durante o processo de alteração da senha do seu banco de dados.

Para proteger o seu banco de dados, você deve atualizar a res­pec­tiva senha com certa frequên­cia. No entanto, ao fazer isso, lembre-se de alterar a senha também no painel de controle do provedor de hos­pe­da­gem e no arquivo wp-config.php. Para tanto, faça download do arquivo wp-config.php, abra-o num editor de texto e edite a seguinte linha:

Define ('DB_PASSWORD', 'Insira a senha aqui');

Insira sua nova senha, salve o arquivo wp-config.php e carregue-o no WordPress por FTP. Atualize o URL no navegador e verifique se o site está sendo exibido nor­mal­mente.

Causa 4: In­for­ma­ções in­cor­re­tas no banco de dados

Erros de digitação podem estragar com­ple­ta­mente um site, causando um crash. Uma letra a mais ou um número errado no nome do banco de dados, no usuário ou na senha é su­fi­ci­ente para im­pos­si­bi­li­tar acessos.

Em sua maioria, processos de ins­ta­la­ção do Wordpress são re­a­li­za­dos pelo painel de controle do provedor de hos­pe­da­gem, que ge­ral­mente oferece um as­sis­tente de ins­ta­la­ção. En­tre­tanto, alguns usuários preferem executar uma ins­ta­la­ção manual. Quem decide instalar o WordPress sem qualquer tipo de as­sis­tên­cia au­to­má­tica deve criar um banco de dados também ma­nu­al­mente. Em sendo este o seu caso, atente-se ao processo, cer­ti­fi­cando-se de ter inserido todos os dados cor­re­ta­mente, em especial o nome do banco de dados, o nome do usuário e a senha. Torne o processo ainda mais seguro uti­li­zando-se do método de copiar e colar.

No processo de copiar e colar, selecione o texto cor­re­ta­mente. Não copie nenhum espaço a mais, pois o WordPress o in­ter­pre­tará como caractere. Espaços são causas comuns de erro que impedem a conexão com o banco de dados. Além disso, atente-se para inserir cada in­for­ma­ção no res­pec­tivo campo durante o processo de ins­ta­la­ção.

Causa 5: Problema com DB_HOST ao migrar site WordPress de provedor

Depois de atualizar o arquivo wp-config.php para conseguir acessar o banco de dados no novo provedor de hos­pe­da­gem, talvez seja ne­ces­sá­rio que você também altere o valor DB_HOST.

Apesar de erros derivados dessa situação serem menos fre­quen­tes, eles podem ocorrer. Algumas empresas de hos­pe­da­gem utilizam valores próprios para o parâmetro DB_HOST do wp-config.php, mas nem sempre isso acontece. Outros hosts definem um URL próprio para o servidor do banco de dados MySQL, que deve ser usado como valor no parâmetro DB_HOST. Às vezes, também pode ser su­fi­ci­ente que você insira o endereço IP do host ao invés do URL do MySQL.

Causa 6: Banco de dados cor­rom­pido

Pode até parecer que sim, mas este erro não é o mesmo que o já explicado mais acima, apesar de estar re­la­ci­o­nado a ele. Pode acontecer de o front-end do seu site funcionar per­fei­ta­mente, mas apre­sen­tar uma mensagem de erro afirmando que uma ou mais tabelas do banco de dados não estão dis­po­ní­veis e que o banco de dados precisa ser reparado.

Abra o arquivo wp-config.php e navegue até o trecho que define o nome do banco de dados, o nome de usuário, a senha e o host. Em host, defina o seguinte:

Define ('WP_ALLOW_REPAIR', true);

Em seguida, salve o arquivo wp-config.php alterado e carregue-o no WordPress por FTP. Feito isso, acesse o seguinte URL:

http://www.seusite.com.br/wp-admin/maint/repair.php

Você en­con­trará duas opções nessa página. A primeira trata-se do botão “Repair Database” e a segunda do botão “Repair and Optimise Database”. Antes de continuar, cer­ti­fi­que-se de estar em posse de um backup completo do seu banco de dados.

Clique na opção “Repair Database”. Quando o processo de reparo for concluído, abra uma nova aba no seu navegador, digite o URL do seu site e verifique se ele está sendo exibido sem erros.

Causa 7: Servidor do banco de dados MySQL inativo

Falhas também podem ocorrer quando o servidor do provedor de hos­pe­da­gem atinge o limite máximo. Se o seu site estiver recebendo mais tráfego do que o esperado, o servidor do seu banco de dados pode se so­bre­car­re­gar. A depender do pacote con­tra­tado, outros sites também estarão uti­li­zando o mesmo servidor que o seu. Basta que um deles so­bre­car­re­gue o servidor para que os demais sejam pre­ju­di­ca­dos.

Para verificar se essa é a fonte do problema que você enfrenta, entre em contato com o seu provedor de hos­pe­da­gem e peça para que ele verifique o status do servidor do banco de dados. Talvez eles encontrem um problema técnico ou informem que o servidor passa por um processo de ma­nu­ten­ção. Mesmo que im­pro­vá­vel, uma simples ligação te­lefô­nica pode dirimir a dúvida.

Ao conversar com o seu provedor de hos­pe­da­gem, explique que você já tentou várias soluções e que não obteve sucesso. Caso seja informado de que o seu site está en­fren­tando tráfego além do esperado, re­co­men­da­mos que você faça um upgrade no plano con­tra­tado para resolver o problema.

A mensagem error es­ta­blishing database con­nec­tion não está entre as mais graves. Na maioria dos casos, você só precisará checar as in­for­ma­ções de con­fi­gu­ra­ção no banco de dados, no arquivo wp-config.php.

4. Tempo limite de conexão esgotado

Essa mensagem de erro ge­ral­mente aparece quando o servidor de um site se encontra so­bre­car­re­gado, não con­se­guindo concluir a so­li­ci­ta­ção do navegador. Ela também pode aparecer quando um servidor é mal con­fi­gu­rado. O tempo limite de uma conexão se esgota quando um site envia mais so­li­ci­ta­ções ao servidor do que ele consegue processar.

Causa 1: Plugin com defeito

Ao deparar-se com este erro, a primeira coisa que você deve fazer é desativar seus plugins em atividade. Se isso resolver o problema, reative-os um a um. Com este método, você poderá detectar o plugin causador do problema. Al­ter­na­ti­va­mente, substitua seu tema atual pelo tema padrão do WordPress.

Causa 2: Limite de memória do PHP esgotado

Outra possível fonte de erro diz respeito à memória do PHP limitada. Neste caso, aumente este limite no arquivo wp-config.php. Para tanto, acesse o arquivo e adicione a seguinte linha de código:

define('WP_MEMORY_LIMIT', '64M');

O comando aumentará o limite de memória do PHP para 64 MB. Contudo, se você tem um plano de hos­pe­da­gem com­par­ti­lhada, só con­se­guirá aumentar a memória do PHP até certo ponto. Caso seu desejo ul­tra­passe a margem es­ta­be­le­cida, você deverá entrar em contato com o seu host para que a ação seja realizada. Vários pro­ve­do­res de hos­pe­da­gem com­par­ti­lhada mantêm baixo o limite de memória do PHP de seus usuários.

Caso você tenha acesso ao seu arquivo php.ini, também poderá aumentar o tempo máximo de execução. No arquivo, navegue até a linha com a opção max_execution_time. Defina o limite como zero para remover com­ple­ta­mente o limite de tempo de execução do PHP ou es­ta­be­leça o valor que achar mais adequado.

Causa 3: Erro 404

Falta comentar o erro 404 not found. Ele ocorre quando um site tenta carregar um arquivo que não existe. Um erro 404 ge­ral­mente diminui a ve­lo­ci­dade de um site, a ponto de atingir o seu tempo limite.

Causa 4: Cookie com defeito

Você pode se deparar com este erro no WordPress se não estiver fa­mi­li­a­ri­zado com o uso do arquivo .htaccess. Em casos ex­tre­ma­mente raros, seu navegador pode salvar cookies de­fei­tu­o­sos relativos ao seu WordPress. Embora difícil de acontecer, a pos­si­bi­li­dade existe, portanto, limpe o cache do navegador e re­car­re­gue sua página para descartar a causa.

5. WordPress não salva nenhuma alteração

Ao acabar de modificar seu tema ou criar uma nova entrada, você atualiza seu site no navegador, mas nenhuma alteração é exibida? A provável solução para este problema é simples: basta que seu navegador re­car­re­gue com­ple­ta­mente a página, acessando-a pelo servidor. Todo navegador salva cópias de sites em cache ou na memória do dis­po­si­tivo. Nos acessos sub­se­quen­tes ao mesmo site, o navegador acessa, então, a cópia salva em cache e não a versão mais recente da página, com o objetivo de acelerar o car­re­ga­mento.

Quando um navegador exibe uma cópia salva em cache, na­tu­ral­mente as al­te­ra­ções mais recentes não apa­re­ce­rão, por se tratar de uma página de­sa­tu­a­li­zada. Para re­car­re­gar com­ple­ta­mente uma página no Firefox, por exemplo, mantenha pres­si­o­nada a com­bi­na­ção de teclas [Ctrl] + [Shift] e, em seguida, pressione a tecla [R]. No Chrome, pressione [Ctrl] + [F5] — a depender das con­fi­gu­ra­ções do seu navegador, os atalhos podem variar.

Pode acontecer de alguns serviços de hos­pe­da­gem con­fi­gu­ra­rem plugins de cache no back-end do WordPress, sem a ciência de seus usuários. Nor­mal­mente, é possível desativar esses plugins pelo painel de con­fi­gu­ra­ção do provedor. Para ter certeza de que esta é a causa do problema que você enfrenta, entre em contato com um fun­ci­o­ná­rio do suporte e pergunte a ele se o seu provedor utiliza plugins de cache. Ao receber uma resposta positiva, solicite sua de­sa­ti­va­ção.

Planos de hos­pe­da­gem es­pe­cí­fi­cos para o WordPress também podem fazer com que al­te­ra­ções não sejam ime­di­a­ta­mente exibidas. Muitos deles con­fi­gu­ram cache no lado do servidor. Se você é cliente de um plano de hos­pe­da­gem para sites WordPress, limpe o cache ma­nu­al­mente. Em muitos casos, você con­se­guirá vi­su­a­li­zar as al­te­ra­ções recentes ao deletá-los.

Se você faz uso de algum proxy reverso de cache HTTP no seu servidor web, al­te­ra­ções re­a­li­za­das nos arquivos não serão exibidas de imediato. Edições só se tornarão visíveis após um de­ter­mi­nado período de tempo, quando a versão do cache expirar e for re­car­re­gada. Re­con­fi­gure seu sistema de cache para eliminar o problema.

O WordPress não armazena cache por padrão. En­tre­tanto, alguns de seus plugins adicionam a fun­ci­o­na­li­dade aos sites, in­de­pen­den­te­mente das con­fi­gu­ra­ções do navegador. Elas ajudam sites a car­re­ga­rem mais ra­pi­da­mente, uma vez que o WordPress passa a recuperar dados em cache, e não do servidor. Bons plugins de cache para WordPress realizam limpezas sempre que um post, uma página ou um co­men­tá­rio é publicado. Contudo, se você alterar seu tema, por exemplo, pode ser que o cache não seja excluído, o que resultará na exibição da versão antiga do site. Nesse caso, recorra às ins­tru­ções de uso do res­pec­tivo plugin para descobrir como excluir o cache.

Se você alterar um arquivo, a nova versão do arquivo será salva, ini­ci­al­mente, apenas no seu dis­po­si­tivo. Por isso, caso nenhuma alteração seja exibida, confira se o arquivo alterado foi realmente carregado no WordPress, no local correto. Ao subs­ti­tuir um arquivo por outro idêntico, a mudança pode não ser re­co­nhe­cida, concluída e salva. Para garantir que o processo ocorra dentro da nor­ma­li­dade, exclua a versão antiga do arquivo alterado servidor do provedor de hos­pe­da­gem.

Você também pode usar um site proxy para re­car­re­gar o seu site a partir dele. Sites proxy não fazem uso de cache, sempre car­re­gando a versão mais recente de uma página.

6. Modo de ma­nu­ten­ção persiste após atu­a­li­za­ção

É comum que você precise atualizar algum plugin, tema ou arquivo do WordPress. Ao executar tal ação, seu site pode sair do ar devido a prováveis conflitos entre o material atu­a­li­zado e o material já existente. Neste caso, uma mensagem de erro interna será exibida.

Quando você desativar o plugin ou a edição no código que de­sen­ca­deou o defeito, é possível que seu site entre no modo de ma­nu­ten­ção do WordPress. Se isso ocorrer, a seguinte mensagem de erro será exibida na página inicial do seu site:

Maintmode.wpe

Ela informa que o site acessado encontra-se no modo de ma­nu­ten­ção (função que cancela o acesso ao WordPress durante processos de atu­a­li­za­ção ou ins­ta­la­ção). Durante atu­a­li­za­ções ou ins­ta­la­ções, alguns processos precisam ser in­ter­rom­pi­dos no back-end, por um curto período de tempo. Para tanto, o WordPress cria um arquivo tem­po­rá­rio. Assim que a ação é concluída, o arquivo tem­po­rá­rio é excluído, per­mi­tindo que o site volte a ser exibido.

Em caso de conflito, algum problema pode surgir e barrar a exclusão au­to­má­tica do arquivo tem­po­rá­rio. Neste caso, o modo de ma­nu­ten­ção con­ti­nu­ará a ser executado, mesmo que a atu­a­li­za­ção tenha sido concluída com sucesso.

A falha é fácil de ser resolvida por usuários fa­mi­li­a­ri­za­dos com programas de FTP. Remova o arquivo de ma­nu­ten­ção di­re­ta­mente no diretório raiz. Faça login no WordPress por FTP e navegue até o diretório raiz (a mesma pasta onde o arquivo wp-config.php está lo­ca­li­zado). Caso não consiga encontrá-lo, pro­va­vel­mente ele estará oculto. Neste caso, habilite a opção “Show hidden files” no cliente. Ao encontrar o arquivo cor­res­pon­dente, exclua-o e atualize o cliente. Em seguida, limpe o cache do seu navegador e re­car­re­gue o site.

Ao invés de tentar resolver este problema, execute os passos abaixo para evitar que ele ocorra:

• Muitos conflitos resultam do fato de avisos de atu­a­li­za­ção serem ignorados pelos usuários. Execute atu­a­li­za­ções assim que elas forem dis­po­ni­bi­li­za­das. Verifique, ainda, de tempos em tempos, quais atu­a­li­za­ções estão sendo re­co­men­da­das pelo próprio WordPress.
• Cer­ti­fi­que-se de que todos os seus plugins e temas sejam com­pa­tí­veis com a versão mais recente do WordPress. Caso contrário, verifique com os de­sen­vol­ve­do­res dos plugins ou temas se eles planejam lançar uma nova versão, e em que momento.
• Não realize uma atu­a­li­za­ção sem antes criar um backup.

7. Erro de sintaxe

Como já men­ci­o­nado an­te­ri­or­mente, até mesmo um pequeno erro de digitação pode fazer um site inteiro parar de funcionar. Apesar de temida, a mensagem syntax error pode ser so­lu­ci­o­nada.

Erros de sintaxe em um código são ge­ral­mente pequenos, mas cruciais. Uma vírgula a mais ou um colchete a menos pode estragar todo o script. Pri­mei­ra­mente, reflita sobre as mo­di­fi­ca­ções re­cen­te­mente exe­cu­ta­das: você inseriu algum snippet da internet ou atualizou algum plugin? Se sim, antes de tudo, verifique nestes locais.

Para corrigir erros de sintaxe, você deverá editar o trecho do código que está causando o erro. Remova-o com­ple­ta­mente ou corrija o seu teor. Se você for iniciante, pode frustrar-se ao descobrir que um pequeno erro pode afetar um site inteiro. Caso tenha inserido o código pelo editor do Painel WordPress, pro­va­vel­mente não con­se­guirá voltar a acessá-lo. Se for o caso, a única maneira de corrigi-lo será trocar o código pro­ble­má­tico di­re­ta­mente por FTP.

Faça login no WordPress com um programa de FTP e navegue até o diretório que contém o tema a ser editado. O código de erro lhe mostrará, com exatidão, arquivo e linha afetados.

Remova com­ple­ta­mente o código re­cen­te­mente alterado ou corrija sua sintaxe. Depois, salve o arquivo e carregue-o no servidor. Se você acessar seu site WordPress sem in­fluên­cias de cache, pro­va­vel­mente ele voltará a funcionar nor­mal­mente.

8. Falha na atu­a­li­za­ção au­to­má­tica

O WordPress oferece ex­ce­len­tes recursos, dentre eles o de atu­a­li­za­ção au­to­má­tica, que torna o uso do CMS muito mais prático. Às vezes, contudo, atu­a­li­za­ções au­to­má­ti­cas podem levar a com­pli­ca­ções.

Se você fizer uso da versão mais atu­a­li­zada do WordPress, não precisará se preocupar com atu­a­li­za­ções de menor peso, re­le­van­tes somente para a segurança. Via de regra, elas são exe­cu­ta­das au­to­ma­ti­ca­mente, em segundo plano, sem que você precise fazer nada. Atu­a­li­za­ções mais im­por­tan­tes, contudo, como novas versões do CMS, requerem ação do usuário, por meio do botão “Update Now”.

Antes de atualizar o seu WordPress, não se esqueça de criar backups do seu banco de dados e de todos os seus arquivos e pastas. Caso receba a mensagem de erro “Update failed”, resolva o problema da seguinte maneira:

Para exibir esse vídeo pre­ci­sa­mos usar cookies de terceiros. Você pode acessar e mudar suas con­fi­gu­ra­ções de cookies here.

Passo 1: Exclua o arquivo de ma­nu­ten­ção: Antes de tudo, exclua o arquivo de ma­nu­ten­ção do WordPress por FTP. Se uma atu­a­li­za­ção do WordPress falhar, delete o res­pec­tivo arquivo para conseguir voltar à página de ad­mi­nis­tra­ção.

Passo 2: Verifique as per­mis­sões de arquivo: Pode acontecer de o WordPress não conseguir criar um diretório de atu­a­li­za­ção por não ter a devida permissão. Ao receber uma mensagem de erro que afirma que não foi possível criar o diretório, verifique se a pasta wp-content possui as per­mis­sões de arquivo 755 adequadas. Também é possível fazer uso de uma au­to­ri­za­ção 777. Lembre-se, no entanto, de reverter a au­to­ri­za­ção assim que tiver resolvido o problema. Você também deverá desativar tem­po­ra­ri­a­mente todos os plugins ao tentar essa solução.

Em seguida, atualize a página do WordPress. Se continuar recebendo mensagens sobre o mesmo erro, exclua a pasta upgrade em wp-content e recrie-a usando uma permissão 777 para a mesma pasta. Se isso funcionar, você precisará se lembrar de voltar a permissão para 755, para minimizar riscos de segurança.

Em alguns casos, problemas de permissão podem ser causados pelo provedor de hos­pe­da­gem. Neste caso, você deverá entrar em contato com o host, para tentar uma solução.

Passo 3: Insira cre­den­ci­ais de FTP ao wp-config.php: Se você* migrou o seu site re­cen­te­mente, pro­va­vel­mente terá alterado a senha do FTP. Em in­ter­va­los regulares*, o Painel do WordPress poderá solicitar essas novas cre­den­ci­ais de FTP, a depender de suas con­fi­gu­ra­ções. Ao invés de inserir seus dados de acesso no Painel sempre que for so­li­ci­tado, adicione-os no arquivo* wp-config.php*. Pri­mei­ra­mente, no entanto, cer­ti­fi­que-se de estar usando os* dados de acesso corretos*. Isso pode ser checado no painel de controle do seu provedor de hos­pe­da­gem.

Abra o arquivo wp-config.php no diretório raiz da sua ins­ta­la­ção WordPress para adicionar alguns comandos a ele. A edição deve ser feita acima da linha com os dizeres:

/ *That’s all, stop editing! Happy blogging.* /

Close

Insira os dados cor­res­pon­den­tes no nos campos relativos ao host FTP, como nome de usuário e senha.

define(‘FS_METHOD’, ‘ftpext’);
define(‘FTP_HOST’, ‘ftp.seusite.com’);
define(‘FTP_USER’, ‘usuário);
define(‘FTP_PASS’, ‘senha);

9. Im­pos­si­bi­li­dade de carregar imagens no WordPress

Di­fi­cul­da­des en­vol­vendo o car­re­ga­mento de imagens são ge­ral­mente causadas por au­to­ri­za­ções de arquivos in­cor­re­tas no diretório de upload. Caso essas não estejam corretas, o WordPress não con­se­guirá salvar os arquivos car­re­ga­dos. Em alguns casos, ele também en­con­trará di­fi­cul­da­des ao tentar exibir arquivos ar­ma­ze­na­dos no diretório de upload. Para corrigir per­mis­sões de arquivo, você precisa utilizar um cliente FTP. Se tudo voltar a funcionar nor­mal­mente, você ainda terá de nor­ma­li­zar as per­mis­sões de arquivo. Caso não saiba como fazer isso, entre em contato com o seu provedor e solicite suporte.

Conecte-se ao seu site por meio do cliente FTP de sua pre­fe­rên­cia e abra a pasta wp-content. Esta conterá a subpasta uploads. Clique, com o botão direito do mouse, na subpasta de uploads e selecione “file per­mis­si­ons”. Uma caixa de diálogo será aberta. Pri­mei­ra­mente, defina as per­mis­sões de arquivo para a própria pasta e somente depois para os sub­di­re­tó­rios.

Comece digitando 744 no campo de valor numérico e marcando a caixa de seleção que cor­res­ponde a “re­cur­si­vely in sub­di­rec­to­ries”. Por fim, clique em “Click for di­rec­to­ries only” e confirme as al­te­ra­ções com o botão “OK”. Seu programa de FTP iniciará, em seguida, o ge­ren­ci­a­mento de arquivos para di­re­tó­rios.

Caso você não obtenha sucesso con­fi­gu­rando per­mis­sões de acesso com 744, tente utilizar o valor 755.

Agora, defina per­mis­sões para todos os arquivos da pasta de uploads. Para fazer isso, clique com o botão direito do mouse na própria pasta e selecione a categoria “File access rights”. Na caixa de diálogo “File access changes”, altere o valor numérico para 644 e habilite a caixa de seleção de “re­cur­si­vely in sub­di­rec­to­ries”. Para finalizar, clique no botão que contém a opção “Only for files” e conclua a con­fi­gu­ra­ção com o botão “OK”.

Seu programa de FTP terá definido, então, per­mis­sões para todos os arquivos. Depois de salvar as al­te­ra­ções, você con­se­guirá fazer upload de imagens novamente, pela página de ad­mi­nis­tra­ção do WordPress.

10. Barra lateral exibida abaixo do conteúdo principal

Quando esse erro do WordPress ocorre, a barra lateral não mais aparece à esquerda ou à direita do conteúdo principal, mas abaixo dele. Isso não só traz prejuízos estéticos, como também afeta a usa­bi­li­dade do site. Mesmo que a falha possa deixar o seu layout com um aspecto inu­ti­li­zá­vel, você ainda con­se­guirá usar o seu tema para realizar a devida correção.

Causa comum do erro pode ser uma quan­ti­dade excessiva de tags div abertas ou fechadas no código HTML. Tags div têm a seguinte aparência no código fonte de uma página do WordPress:

<div> </div>

Essas marcações são uti­li­za­das para abrir e fechar elementos HTML em um site. Contudo, quando elas são uti­li­za­das em excesso, podem não ser im­ple­men­ta­das cor­re­ta­mente, afetando o layout. Caso o problema ocorra somente em um post ou página, muito pro­va­vel­mente ele estará sendo causado por* tags div*. Um jeito simples de comprovar a origem do erro é uti­li­zando um validador online de HTML.

Outra pos­si­bi­li­dade é que o erro tenha se in­fil­trado no seu arquivo CSS de estilo. Considere esta a possível causa se você tiver feito al­te­ra­ções recentes no local. Por exemplo, se você tiver feito es­pe­ci­fi­ca­ções para o conteúdo principal e para a barra lateral con­fli­tan­tes, o res­pec­tivo layout não será criado de forma correta. Es­pe­ci­fi­ca­ções in­cor­re­tas de margem e pre­en­chi­mento também podem levar a falhas de exibição.

Também pode ser que as pro­pri­e­da­des de flutuação da sua barra lateral estejam de­sa­ti­va­das no CSS. Assim, ela deixará de se alinhar à direita ou à esquerda. Verifique a definição de flutuação para descartar a fonte de erro.