O aviso “Erro ao estabelecer uma conexão com o banco de dados” no WordPress é um erro fatal que torna seu site inacessível aos usuários. Isso acontece quando o WordPress não consegue se conectar ao banco de dados.
Como vários fatores podem afetar essa conexão, o erro pode ser um pouco difícil de solucionar para iniciantes.
Há 16 anos, administramos nosso blog no WordPress e encontramos vários erros e avisos, inclusive o “Erro ao estabelecer uma conexão com o banco de dados”. Com nossa experiência e muita tentativa e erro, aprendemos a solucionar esses problemas sem interromper nosso site.
Neste artigo, mostraremos como corrigir facilmente o “Erro ao estabelecer uma conexão com o banco de dados” em seu site WordPress, passo a passo.
Qual é a causa do erro ao estabelecer uma conexão com o banco de dados no WordPress?
Um banco de dados é um software que facilita o armazenamento, a organização e a recuperação de dados de outro software.
Como um sistema de gerenciamento de conteúdo, o WordPress usa um banco de dados para armazenar todo o seu conteúdo e outros dados do site. Em seguida, ele se conecta ao banco de dados sempre que alguém visita seu site.
O WordPress precisa das seguintes informações para se conectar ao banco de dados:
- Seu nome de banco de dados
- Nome de usuário e senha do banco de dados
- Servidor de banco de dados
Essas informações são armazenadas em seu arquivo de configuração do WordPress, chamado wp-config.php.
Se alguma dessas informações estiver incorreta, o WordPress não conseguirá se conectar ao seu servidor de banco de dados e você verá o erro “Error establishing a database connection” (Erro ao estabelecer uma conexão com o banco de dados).
Esse é um dos erros mais comuns do WordPress. Além das credenciais incorretas, esse erro também pode aparecer se o servidor do banco de dados estiver inativo ou se os arquivos do banco de dados estiverem corrompidos.
Dito isso, vamos dar uma olhada em como corrigir o problema “Erro ao estabelecer conexão com o banco de dados” no WordPress com uma solução de problemas passo a passo.
1. Verifique as credenciais do banco de dados do WordPress
Credenciais incorretas são a causa mais comum do erro de conexão com o banco de dados. Se você mudou recentemente seu site do WordPress para um novo host, provavelmente esse é o problema.
Suas credenciais de banco de dados do WordPress são armazenadas no arquivo wp-config.php. Esse é o arquivo de configuração do WordPress que contém configurações importantes, inclusive informações sobre o banco de dados.
Se você nunca editou um arquivo wp-config.php antes, dê uma olhada no nosso guia para iniciantes sobre como editar o arquivo wp-config.php para obter mais instruções.
Você procurará as seguintes linhas no arquivo wp-config.php:
// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'database_name_here' );
/** MySQL database username */
define( 'DB_USER', 'username_here' );
/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );
/** MySQL hostname */
define( 'DB_HOST', 'localhost' );
Aqui, você deve se certificar de que as informações sobre o nome do banco de dados, o nome de usuário, a senha e o host do banco de dados estejam corretas.
Você pode confirmar essas informações no painel da sua conta de hospedagem do WordPress. Para este tutorial, usaremos o Bluehost, mas o processo também será semelhante para outros painéis de hospedagem.
Ao fazer login, clique na guia “Website” na coluna da esquerda e, em seguida, mude para a guia “Advanced” (Avançado). Em seguida, role para baixo até a seção “Database” (Banco de dados) e clique no botão “Manage” (Gerenciar) ao lado dela.
Isso abrirá a página Bancos de dados MySQL no cPanel em uma nova janela.
Aqui, você pode encontrar o nome do banco de dados e o nome de usuário na seção “Current Database” (Banco de dados atual). Não se esqueça de copiar e colar esses detalhes em um bloco de notas para poder adicioná-los ao arquivo wp-config.
Em seguida, role para baixo até a seção “Current Users” (Usuários atuais), onde você pode clicar no link “Change Password” (Alterar senha) ao lado do nome do seu banco de dados.
Isso o levará a uma nova tela, na qual você poderá alterar a senha do banco de dados de acordo com sua preferência.
Depois de confirmar todos os detalhes do banco de dados, você poderá alterar essas informações no arquivo wp-config.php, se necessário.
Depois disso, tente visitar seu site novamente para ver se o erro de conexão com o banco de dados desapareceu.
Se você ainda puder ver o erro, isso significa que algo mais está errado.
2. Verifique as informações do host do banco de dados
Se tiver certeza de que as informações de nome do banco de dados, nome de usuário e senha estão corretas, certifique-se de que está usando as informações corretas do host do banco de dados.
A maioria das empresas de hospedagem WordPress usa o localhost como seu host de banco de dados. No entanto, algumas empresas de hospedagem gerenciada do WordPress usam servidores separados para hospedar bancos de dados. Nesse caso, as informações do host do banco de dados não serão localhost.
Isso significa que você precisará entrar em contato com a empresa de hospedagem do WordPress para confirmar esses detalhes.
3. Reparar o banco de dados do WordPress
Agora, você pode estar recebendo um erro diferente no painel wp-admin, como “Uma ou mais tabelas de banco de dados não estão disponíveis” ou “O banco de dados pode precisar ser reparado”. Nesse caso, você precisa reparar seu banco de dados.
Você pode fazer isso adicionando a seguinte linha no arquivo wp-config.php. Certifique-se de adicioná-la logo antes da linha “That’s all, stop editing! Happy blogging”:
define('WP_ALLOW_REPAIR', true);
Depois de fazer isso, você poderá ver as configurações visitando esta página: http://www.yoursite.com/wp-admin/maint/repair.php. Apenas certifique-se de substituir yoursite.com por seu próprio nome de domínio.
Aqui, você deve clicar no botão “Repair Database” (Reparar banco de dados) para iniciar o processo.
Observação: o usuário não precisa estar conectado para acessar a página de reparo do banco de dados. Quando terminar de reparar e otimizar o banco de dados, remova essa linha de código do wp-config.php.
No entanto, se não quiser adicionar nenhum código ao site, você também poderá reparar o banco de dados usando o cPanel da sua conta de hospedagem.
Vá em frente e visite sua conta de hospedagem, onde você deve abrir a página “Websites” na coluna da esquerda. Em seguida, vá para a guia “Advanced” (Avançado) e clique no botão “Manage” (Gerenciar) na seção Database (Banco de dados).
Isso abrirá o cPanel em uma nova guia. Aqui, role para baixo até a seção “Modify Databases” (Modificar bancos de dados) e escolha o nome do seu banco de dados no menu suspenso “Repair Database” (Reparar banco de dados).
Depois de fazer isso, basta clicar no botão “Repair Database” (Reparar banco de dados) para iniciar o processo.
O painel de hospedagem agora reparará automaticamente o banco de dados para você.
Quando o processo for concluído, você também verá uma mensagem de sucesso.
Agora você pode visitar seu site do WordPress para ver se o erro foi resolvido ou não.
4. Verificar se o servidor de banco de dados está inativo
Se tudo parecer estar correto e o WordPress ainda não conseguir se conectar ao banco de dados, o servidor do banco de dados(servidor MySQL) pode estar inativo.
Isso pode ocorrer devido ao tráfego intenso em um servidor. Seu servidor host simplesmente não consegue lidar com a carga (especialmente quando você está em uma hospedagem compartilhada).
Devido a isso, seu site ficará lento e poderá até mesmo gerar um erro para alguns usuários. Nesse caso, você deve entrar em contato com o provedor de hospedagem por telefone ou chat ao vivo e perguntar se o servidor MySQL é responsivo.
Além disso, se você tiver outros sites em execução no mesmo servidor, poderá verificar esses sites para confirmar se o servidor SQL está inativo.
Se você não tiver nenhum outro site na mesma conta de hospedagem, basta acessar o painel de controle de hospedagem e alternar para a guia “Avançado”.
Depois disso, clique no botão “Manage” (Gerenciar) ao lado da seção phpMyAdmin.
Isso abrirá o phpMyAdmin em uma nova janela, na qual você deverá clicar na opção “Database” (Banco de dados) na parte superior.
Depois disso, clique no nome do banco de dados para acessar suas configurações. Se conseguir fazer isso, então é hora de verificar se o usuário do banco de dados tem permissões suficientes.
Para fazer isso, você precisa criar um novo arquivo chamado testconnection.php e colar o seguinte código nele:
<?php
$link = mysqli_connect('localhost', 'username', 'password');
if (!$link) {
die('Could not connect: ' . mysqli_error());
}
echo 'Connected successfully';
mysqli_close($link);
?>
Ao colar o código, certifique-se de substituir o nome de usuário e a senha pelos seus próprios. Agora você pode carregar esse arquivo no seu site e acessá-lo por meio de um navegador da Web.
Se o script for conectado com êxito, isso significa que o usuário tem permissões suficientes e que outra coisa está causando o erro.
Agora, você deve voltar ao seu arquivo wp-config e verificá-lo para garantir que todos os detalhes estejam corretos e sem erros de digitação.
Soluções adicionais que funcionaram para os usuários
Se as dicas de solução de problemas mencionadas acima não conseguirem corrigir o erro de conexão com o banco de dados em seu site, você poderá tentar estas etapas adicionais.
Conforme relatado por nossos usuários, essas etapas ajudaram alguns deles a resolver o erro de conexão com o banco de dados em seus sites.
1. Atualize o URL do site WordPress
Você pode tentar atualizar o URL do site do WordPress usando o phpMyAdmin no cPanel.
Basta acessar o phpMyAdmin no painel da sua conta de hospedagem e selecionar o banco de dados do WordPress na lista.
Depois disso, mude para o menu SQL na parte superior e digite a seguinte consulta MySQL:
UPDATE wp_options SET option_value='YOUR_SITE_URL' WHERE option_name='siteurl'
Ele deve ter a seguinte aparência:
Não se esqueça de fornecer o URL do seu próprio site e alterar wp_options para o nome da sua própria tabela, pois você pode ter alterado o prefixo da tabela do WordPress.
2. Reinicialização do servidor da Web
Os usuários de servidores dedicados, servidores locais e servidores virtuais privados (VPS) podem tentar reiniciar seus servidores.
Isso reiniciará seu servidor da Web e de banco de dados, o que pode corrigir algumas falhas temporárias que estão causando o erro.
3. Pedir ajuda
Se tudo o mais falhar, talvez seja necessário entrar em contato com a empresa de hospedagem na Web. Todas as boas empresas de hospedagem WordPress o ajudarão a solucionar o problema, indicarão a direção certa ou até mesmo o resolverão para você.
Você também pode contratar desenvolvedores do WordPress usando uma plataforma como o WPBeginner Pro Services para ajudá-lo a corrigir esse problema por preços razoáveis. Temos uma equipe dedicada de desenvolvedores especializados em quem você pode confiar para resolver qualquer problema do WordPress.
Você também pode usar o serviço para manutenção de sites, reparo de sites invadidos, otimização de velocidade, reconstrução de sites e otimização de SEO.
Esperamos que este artigo tenha ajudado a corrigir o problema “Erro ao estabelecer uma conexão com o banco de dados” no WordPress. Talvez você também queira consultar nosso guia de solução de problemas do WordPress para obter dicas sobre como resolver problemas do WordPress por conta própria ou nosso tutorial sobre como adicionar uma página de erro de banco de dados personalizada no WordPress.
Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.
Riya Mehta
Hey,
Today I got the same error and I fixed this by giving all privilege(Permissions) to user under the database defined in configuration file that is wp.config file.
bog
What happened to me was that my hard drive (linux) spontaneously went into read-only mode. Out of nowhere. I know this is an obscure cause, but nonetheless I thought I’d pitch in. (usually the sign of a dieing drive, I’m told).
Masood Ahmad
Hi everyone,
In my case it was very simple. The password for MySQL database and the password in the wp_config.php must be same, ignorant of the fact, I changed the password for mysql database and remained upset the whole day. Until by chance I reverted the change. My site was up and live in the next second.
Jamie
When i rename index.php to index_.php — then the back end of the website loads up fine
Pages on the website give a normal ‘Not Found’ Apache error
——
When i restore the index.php filename — then nothing works, and I receive ‘error establishing a database connection’ on public facing pages. And wordpress’ own ‘error establishing a databse connection’ text box when I visit /wp-admin
Any help you can offer will be much appreciated!
Tony thomas
When you are operating in google cloud, you may often receive this error if your RAM is using more resources.
login to google cloud
Find the instance from ‘compute engine’. Click on the top menu to find ‘compute engine’
login to SSH
type sudo bash (to enter as root)
Then type/copy paste :
systemctl start mariadb.service (in centos 7)
error establishing database will be solved instantly.
Jarrett
If you’re using mysql, you can do this
sudo service mysql restart
Thanks for the pointer!
Sabir Guiri
It worked perfectly. thank you so much!
Yudha Haris
Thanks So Much IT’S WORK..
Tim
Thank you for this article…it’s the most useful on the web I would say.
I still have the problem anyway (host is Godaddy)…I created the testconnection.php page and i get this error message :
Warning: mysql_connect(): Access denied for user ‘username’@’hostIP’ (using password: YES) in /home/content/n3pnexwpnas01_data02/52/3027952/html/wp-config.php on line 106
Could not connect: Access denied for user ‘username’@’hostIP’ (using password: YES)
– username being the username I use to connect to database via Phpmyadmin
– password being the password I use to connect to database via Phpmyadmin
– hostIP being the hostname value I found in the database variables in Phpmyadmin
I have been stuck for hours now…can you help me on this ? I have no idea what to do and how to do it…
Thank you in advance
WPBeginner Support
The most likely reason for this is incorrect information in your wp-config.php file. This could be your MySQL host, username, password, or database name. IF you are using hostname IP, then try adding port to it. Ask your web host for support.
Administrador
Prashant
Dear Friends,
I M New and very little to know about wordpress today i face a prob
when i try to publish a new post or update the older one and push the button publish or updates its automatically redirected to home page nothing happen not change in updated post not publish a new post please help me if anybody know about such an issue.
thanks
WPBeginner Support
Try updating permalinks by visiting Settings->Permalinks page and just click on the update button.
Administrador
Abel
Hey, thanks, this worked for me, thumps up!
Robert DeRobertis
Thank you, Thank you, Thank you.
I was hacked recently and changed the passwords to my website to something more secure. I missed updating the config file. This saved the day.
Cássio Sá
My friend, i’m having tears of joy right now, you saved my life. The problem was in the config file. I imported the old database and changed the credencials on it, but haven’t changed the credencials in the config file. Thank you very much for the tip.
Ali
I just change http to HTTPS Now my site is not opening and showing same error please tell me what to do now ?
Ryan
Have you changed the site url in the database in WP_Options table?
feizel
Thank you so much. i have been searching for the solution like all night.
Paul
Hey great article about how to troubleshoot database connection errors.
Might be good idea to link to your old article about making a custom dB error page. Otherwise if utilising good caching program it can take a while before actually realise something is wrong. This article and the mail function means you can be notified instantly and provide a nice image and custom text which is more professional than the default message.
https://www.wpbeginner.com/wp-tutorials/how-to-add-a-custom-database-error-page-in-wordpress/
stephanie wandke
Thanks for this article! It was definitely a database user issue and when I added a new user and password, changed the wp-config file, BAM the site was back. You made it easy and I solved my problem in under 15 minutes. Thank you!
Edward
Godaddy customer. Getting this same issue.
Database was working fine. What worked for me was to go into wp_config and change the following line:
define(‘DB_HOST’, ‘localhost’); [the db_host was something different, not localhost]
to
define(‘DB_HOST’, ‘[my IP address]’) and it worked fine
Thanks for the tip!
Daryl
This worked for me on my GoDaddy Site
Shakti
Sir help me please
My website is loading, and working fine but I get error establishing database connection when I tried wp-admin and again I reloaded page 3-10 times and my site is working. Again I get that error unexpectedly.
WPBeginner Support
It seems that your database server is not responding. Please contact your web host and tell them what’s happening.
Administrador
Shakti
Ok Thankyou Sir
Shelly
My site goes down and I get this same error message at the same time every night. It lasts for about an hour and a half, and then the site is back up again. Would that indicate an issue with my hosting service?
Harinath
Did you happen to find any resolution for it?
Liesje
Thanks a lot for this article ! Piece of cake this way
Saved me a lot of work and headaches.
Kinders regards,
Liesje
praveen
i have error in wp-admin page. its says Error establishing a database connection. how to solve it .
Ian Wells
This occurred once for me on my EC2 AWS instance. The cause was I am using a small t2. micro server, and I sometimes got too many httpd requests coming in, especially when I turned on my AWS health checks which increase traffic. I reconfigured my /etc/httpd/conf/httpd.conf per instructions here: https://wordpress.org/support/topic/how-to-optimize-apache-for-wordpress and so far, so good. I no longer see 20 or more httpd processes running at once, followed by out of memory and data base disconnected.
Ian Wells
This error kept occurring. I could clear it by rebooting EC2 but not very satisfactory. Then I noticed my EC2 installation was out of date, so I ran “sudo yum update” on the server. Looking much more stable now.
ani
nice …exhaustive ..detailed information …i fought with my hosting guys and demanded a root cause for slow DB performance /connectivity…these guys kept recommended to upgrade hosting account to dedicated setup ..POST gave insights on probable problems and ways to tackle .
Thanks !
alexsbutler
You can also try Kernel for Word file repair tool to repair your corrupted Word file easily.
Ken Pyle
Thanks for the article. Lunarpages is my host and around 2:30 AM (thanks Jetpack for monitoring my site), my site quit working and I also had the “Error Establishing Connection to the Database Error.”
How I fixed the problem was to re-enter the password into the MySQL database (got there via Cpanel). I used the same password that was already in the config file, so that way I only had to change one variable.
I have tried it on 3 Wordpress installs so far and it seems to work, as Jetpack informed me that my site is back up after being down for 16 hours.
It is a mystery as to why it disconnected.
Jason Teale
I am on Lunarpages as well. So basically, I just have to re-enter the the blog password and that is it? What was the one variable that you changed?
Mike B
I also am on Lunarpages. I also needed to re-enter my password in C-Panel. Something must have happened with Lunarpages this morning.
NickP
Thank you, Ken! Exactly what I needed to know. Back up and running in minutes…
Harm
I made some changes in wp_user and wp_metadata to create a new admin. Then I get this message. I tried to look at the wp-config-file, but get the same message! What can I do more?
Scott
Sort of silly looking back at this, but it might help someone else so I think it’s worth sharing. Recently had a site that was set up to use Cloudflare as it’s CDN. All the DNS “A” records were set except for the one for “mysql.domain.com”, so even using the testconnection.php trick didn’t work (on Dreamhost that doesn’t use localhost). Simply added the “A” record in Cloudflare and life was good again.
Sharad Gupta
An awesome solution for a very difficult and annoying problem .
MaSilat
Awesome. It helped me and solve DB problem.
Mohamed Azazy
You can also restart your MySQL service if you’re using VPS.
– sudo service mysql restart
Worked for me!
Dustin Overbeck
Thanks for this suggestion. Restarting mysql was the magic bullet in my situation.
Michael D
Thanks for this article, it helped!
We had the error occurring in both the root domain and wp-login. Changing ‘localhost’ to the IP in wp-config.php fixed it.
Rav
It appeared my ‘localhost’ was not working so I just added the direct address of my hosting provider (mysql.hostinger.co.uk) and everything started working again!
Thanks for the help!
Christopher
Actually, I’m getting “Error establishing a database connection” in my home page only. All other pages are working fine. Please let me know what to do.
Adrienne
My old client has this issue now, and her site is about 3 years old and hasn’t been updated. I think the theme and all the changes has corrupted this site. It needs to be scrapped and redone…. now, I have to find a simple way to do it. lol
Nicole
I was moving a multisite system- I had to switch out the old website name in my database, and in the .htaccess and wp-config files
m3d01
Hello guys,
I found the problem that my hosting service made update and that lead to change in the DB_HOST number so i change it back by the new one by edit the config file and the site is back again to work finally
John Bert
Recently I have transferred from Arvixe to Phi9 web host.
Actually I forgot to change the previous host “MySQL Connections Strings” in wp-config.php. Now it’s working.
Thank you for your great help I really appreciate it!
Micky
I have seen this error. I was putting the wrong MySQL port in connection line. Your post helped me fix it.
Carl
This seems logical. But I go through each step and nothing changes. Why is this so complex?
I liked the idea of the database repair but it appears that Wordpress would need to be up and running to hit the Repair Database button. I’ve been at this for 2 days. Is there a place to go where I can find the problem by looking at some code? This all seems so vague.
Leonard Rattini
As I worked in computer application design for 30-years, and I’m also registered as a Certified Computer Professional, many people, to impress, use the “database” term incorrectly.
Database is a different data retaining methodology than what was use before its time. Back in the earlier days, data was retained on liked related 80-column cards and collectively they were know as a file. For instant many invoice records, collectively were known as the Invoice File. Medical records collectively, were known as a Medical file, etc.
In early big main frame computer days, before PC’s that came along, they processed these “80-column fixed-records.” With the advent of the Internet and distributed multiple keyboards, data then was recorded as “data packets” and they are stored in a “database,” which is a three-dimensional format structure stored in the computer. Then at the right time, to process, data items needed “linked’ data packets then allowed for this to happen which then looked like a record we are familiar with.
An application must be designed as a database base application that includes a Database Administrator person, otherwise its application is not a database application.
A database application served two main purposes versus the old file methods used in the olden days before the Internet and distributed keyboards. One was to capture data items at first point of (data) entry. And secondly, it is intended to eliminate “data-redundancy.” Leonard Rattini, CCP (to know of my CCP credentials, google ICCP)
Toby Harding
I’ve seen this error a few times now, with my Wordpress that is hosted on an Amazon EC2 box in their AWS cloud. Simple way to fix the issue is to restart the instance from the AWS admin console.
Jake B
Thanks for the article. I was able to work through each step until I found my issue.
Unknown
Hey, i am getting this error while installing wordpress “Error establishing a database connection” what should i do to get rid of this error .I’ve tried everything like changed database name , deleted previous databases but still wordpress is not is not installed yet. Please help !
David Clarke
Solved my issue in minutes thanks to this helpful article, thanks a lot!
Friday
I can’t help it, since i created my site i haven’t touched that area can you help me to do it
mikhail
Thanks for the article, it helps.
For me it’s because I change my database user password from CPanel but apparently the wpconfig.php file won’t change automatically when i changed my database user password .
I have to change it manually in
define(‘DB_PASSWORD’, ‘[insert your password here]’);
Juan Loayza
Thks so much! It was a headache … until I found your solution…
Tapiwa
Dude! Thank you so much! I just fixed my website thank to this article and your comment.
Max Demian
Really useful, thank you.
James Kalmakoff
The article was very useful and I resolved my Database connection problem. A further place to look for errors is in the MySQL database. Be sure that the ‘database_username’ and the ‘database_name’ are correctly assigned to each other and that there are no typos!
Dawn
I just got this error, I copy and Pasted a page to a word document, I saw that there was a paragragh added with ads and links to sites like viagra ect. I removed the ad/links paragragh and re-pasted the text back into my webpage. I was on the second page and posted the updates, when I received this error…any one else had this?
J
Hey – this won’t help your problem, but you shouldn’t be using Word to edit these files. You want to use a simpler program like Notepad/TextEdit etc.
Peter Gough
Many thanks for this article. Very, very useful.