Erro de conexão com o banco de dados (Error establishing a database connection)

A mensagem "Error establishing a database connection" (ou "Erro ao estabelecer uma conexão com o banco de dados") aparece quando o site não consegue conectar ao MySQL. Ela pode ser permanente, quando há erro de configuração, ou intermitente, quando a aplicação esgota as conexões ou os recursos da conta.

Se o erro é permanente

Confira os dados de conexão no wp-config.php (ou no arquivo de configuração da sua aplicação):

define('DB_NAME', 'usuario_banco');
define('DB_USER', 'usuario_user');
define('DB_PASSWORD', 'sua_senha');
define('DB_HOST', 'localhost');

1. Compare o nome do banco e o do usuário com o que aparece no painel. No cPanel e no DirectAdmin eles levam o prefixo da conta (por exemplo, usuario_).
2. Confirme no painel que o usuário existe e está associado ao banco com todos os privilégios:
   • cPanel: Bancos de dados MySQL.
   • DirectAdmin: Gerenciamento MySQL (MySQL Management).
   • Plesk: Bancos de dados.
3. Se não lembra a senha do usuário do banco, troque-a no painel e atualize o wp-config.php com a nova.
4. Confira se o wp-config.php não está vazio ou alterado. Isso acontece em sites invadidos; veja "Site invadido ou com malware: primeiros passos".

Se o erro aparece e some sozinho

O caso mais comum é o limite de conexões simultâneas por usuário de banco de dados, atualmente 15. Quando a aplicação atinge esse número, as novas conexões são recusadas até as anteriores fecharem. Esse limite é definido pela plataforma e não é aumentado em hospedagem ou revenda.

O que reduz o número de conexões:

• Cache. Cache de página e de objeto evita consultas repetidas. Veja "Cache no WordPress com LiteSpeed Cache e Redis".
• Robôs e ataques. Muitos acessos simultâneos abrem muitas conexões. O Cloudflare ajuda a filtrar.
• Plugins e código. Plugins mal otimizados e conexões persistentes mantêm conexões abertas. O desenvolvedor deve fechar as conexões após o uso e revisar consultas lentas.
• Rotinas agendadas. Crons e integrações rodando ao mesmo tempo somam conexões. Espalhe os horários.

Picos de I/O da conta também podem derrubar a conexão com o banco. Confira em "Uso de recursos" (veja "Erro 503 ou 508: limites de recursos da conta").

Se a aplicação já está otimizada e continua precisando de mais conexões, a equipe encaminha o caso para o setor de Solução e Relacionamento avaliar um ambiente próprio.

Se vários sites caíram ao mesmo tempo

Confira a página de status em https://www.valuehost.com.br/cliente/serverstatus.php. Uma falha no serviço de banco do servidor é tratada pela equipe.

Se não resolver

Abra um ticket com:

• o domínio e o horário em que o erro apareceu;
• se o erro é constante ou intermitente;
• o nome do banco e do usuário configurados no site (sem a senha).

Não inclua senhas no ticket.