---
title: "Como corrigir Error establishing a database connection"
url: https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/
date: 2026-06-13
author: "Clayton Margiotti"
---

# Como corrigir Error establishing a database connection

## O que é o erro de conexão com o banco de dados?

Esse erro aparece quando o PHP do WordPress não consegue abrir uma conexão com o servidor de banco de dados (MySQL ou MariaDB). Sem essa conexão o WordPress não lê posts, opções nem usuários, então o site inteiro fica fora do ar, mostrando apenas a frase do erro em tela branca.

## Como identificar

- Tela branca com apenas a frase "Error establishing a database connection".

- O mesmo erro aparece tanto no front-end quanto no wp-admin.

- Às vezes o wp-admin mostra "One or more database tables are unavailable" e sugere reparar o banco.

- O erro surge após migrar de host, trocar a senha do banco ou em horário de pico de tráfego.

**Antes de começar:** Faça backup do wp-config.php antes de editá-lo e remova a linha WP_ALLOW_REPAIR assim que terminar o reparo (ela deixa a rota de reparo aberta sem login).

## Como prevenir

- Anote as credenciais do banco em local seguro e atualize o wp-config.php sempre que trocar a senha

- Monitore o uso de recursos do plano para não estourar o limite de conexões em campanhas

- Mantenha backups automáticos do banco para restaurar rápido em caso de corrupção

## Erros relacionados

- [Como reparar tabelas corrompidas no WordPress](https://full.services/wp-fixer/reparar-tabelas-corrompidas-wordpress/)

- [Como corrigir One or more database tables are unavailable](https://full.services/wp-fixer/corrigir-database-tables-unavailable-wordpress/)

- [Como corrigir MySQL server has gone away](https://full.services/wp-fixer/corrigir-mysql-server-has-gone-away/)


---

## Metadados Estruturados (Schema.org)

```json-ld
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://full.services/#org",
            "name": "FULL Services",
            "url": "https://full.services/",
            "sameAs": [
                "https://www.instagram.com/fullservicesbr",
                "https://www.facebook.com/fullservices.br",
                "https://www.linkedin.com/company/fullservicesbr/"
            ],
            "knowsAbout": [
                "WordPress",
                "WordPress Hosting",
                "Web Development",
                "Performance Optimization",
                "WordPress Security",
                "SEO para WordPress"
            ],
            "award": [
                "Gold Medal - The WP Weekly Awards 2023",
                "Gold Medal - The WP Weekly Awards 2024"
            ],
            "logo": {
                "@type": "ImageObject",
                "url": "https://full.services/wp-content/uploads/full-services-logo.png",
                "width": 200,
                "height": 60
            },
            "hasCredential": {
                "@type": "EducationalOccupationalCredential",
                "credentialCategory": "certification",
                "name": "CVE Numbering Authority (CNA)",
                "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.",
                "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL",
                "recognizedBy": {
                    "@type": "Organization",
                    "name": "CISA — Cybersecurity and Infrastructure Security Agency",
                    "url": "https://www.cisa.gov/",
                    "sameAs": "https://www.cisa.gov/"
                }
            }
        },
        {
            "@type": "TechArticle",
            "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#article",
            "headline": "Como corrigir Error establishing a database connection",
            "url": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/",
            "inLanguage": "pt-BR",
            "datePublished": "2026-06-13T21:16:01-03:00",
            "dateModified": "2026-06-13T23:16:28-03:00",
            "author": {
                "@id": "https://full.services/#org"
            },
            "publisher": {
                "@id": "https://full.services/#org"
            },
            "isAccessibleForFree": true,
            "about": [
                {
                    "@type": "Thing",
                    "@id": "https://www.wikidata.org/wiki/Q13166",
                    "name": "WordPress",
                    "sameAs": "https://www.wikidata.org/wiki/Q13166",
                    "url": "https://wordpress.org/"
                },
                {
                    "@type": "Thing",
                    "name": "Banco de dados"
                }
            ],
            "mentions": {
                "@type": "Thing",
                "@id": "https://www.wikidata.org/wiki/Q13166",
                "name": "WordPress",
                "sameAs": "https://www.wikidata.org/wiki/Q13166",
                "url": "https://wordpress.org/"
            },
            "mainEntityOfPage": {
                "@type": "WebPage",
                "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/"
            },
            "wordCount": 447,
            "description": "\"Error establishing a database connection\" significa que o WordPress não conseguiu falar com o MySQL. Quase sempre vem de credenciais erradas no wp-config.php, do servidor de banco fora do ar ou de tabelas corrompidas.",
            "articleSection": "Banco de dados",
            "keywords": "banco de dados wordpress nao conecta, erro de conexao com banco de dados wordpress, error establishing a database connection, wp-config db_host wordpress",
            "proficiencyLevel": "Advanced",
            "citation": {
                "@type": "CreativeWork",
                "url": "https://wordpress.org/documentation/article/common-wordpress-errors/",
                "name": "WordPress.org — Common WordPress Errors"
            },
            "mainEntity": {
                "@type": "SoftwareSourceCode",
                "name": "Como corrigir Error establishing a database connection",
                "programmingLanguage": "PHP",
                "codeRepository": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/",
                "isAccessibleForFree": true,
                "text": "// Credenciais do banco no wp-config.php (ajuste aos dados do seu painel)\ndefine( 'DB_NAME', 'nome_do_banco' );\ndefine( 'DB_USER', 'usuario_do_banco' );\ndefine( 'DB_PASSWORD', 'senha_do_banco' );\ndefine( 'DB_HOST', 'localhost' ); // alguns provedores usam 127.0.0.1 ou um host dedicado"
            }
        },
        {
            "@type": "FAQPage",
            "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#faq",
            "isPartOf": {
                "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#article"
            },
            "isAccessibleForFree": true,
            "mainEntity": [
                {
                    "@type": "Question",
                    "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#faq-q1",
                    "name": "O erro aparece no site e no wp-admin ao mesmo tempo. Por quê?",
                    "inLanguage": "pt-BR",
                    "acceptedAnswer": {
                        "@type": "Answer",
                        "text": "Porque a conexão com o banco é a mesma para os dois. Se o WordPress não conecta ao MySQL, nada que dependa do banco carrega, nem o front-end nem o painel.",
                        "author": {
                            "@id": "https://full.services/#org"
                        }
                    }
                },
                {
                    "@type": "Question",
                    "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#faq-q2",
                    "name": "Conferi as credenciais e estão certas. E agora?",
                    "inLanguage": "pt-BR",
                    "acceptedAnswer": {
                        "@type": "Answer",
                        "text": "Provavelmente o servidor MySQL está fora do ar ou sobrecarregado. Teste o phpMyAdmin: se ele também não abrir, o problema é no servidor de banco e o suporte da hospedagem precisa agir.",
                        "author": {
                            "@id": "https://full.services/#org"
                        }
                    }
                },
                {
                    "@type": "Question",
                    "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#faq-q3",
                    "name": "Devo usar localhost ou 127.0.0.1 no DB_HOST?",
                    "inLanguage": "pt-BR",
                    "acceptedAnswer": {
                        "@type": "Answer",
                        "text": "Depende do provedor. Muitos usam 'localhost', mas hospedagens com banco em servidor separado exigem '127.0.0.1' ou um host específico. Teste os dois se não tiver certeza.",
                        "author": {
                            "@id": "https://full.services/#org"
                        }
                    }
                },
                {
                    "@type": "Question",
                    "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#faq-q4",
                    "name": "O que faz a linha WP_ALLOW_REPAIR?",
                    "inLanguage": "pt-BR",
                    "acceptedAnswer": {
                        "@type": "Answer",
                        "text": "Ela libera a rota /wp-admin/maint/repair.php para reparar e otimizar tabelas corrompidas sem login. Use só durante o reparo e remova depois, pois deixa a rota aberta.",
                        "author": {
                            "@id": "https://full.services/#org"
                        }
                    }
                },
                {
                    "@type": "Question",
                    "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#faq-q5",
                    "name": "Posso perder dados ao reparar o banco?",
                    "inLanguage": "pt-BR",
                    "acceptedAnswer": {
                        "@type": "Answer",
                        "text": "O WP_ALLOW_REPAIR repara e otimiza as tabelas sem apagar conteúdo. Mesmo assim, faça backup do banco antes: qualquer operação sobre uma tabela corrompida tem algum risco.",
                        "author": {
                            "@id": "https://full.services/#org"
                        }
                    }
                },
                {
                    "@type": "Question",
                    "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#faq-q6",
                    "name": "Mudei de hospedagem e deu esse erro. O que conferir primeiro?",
                    "inLanguage": "pt-BR",
                    "acceptedAnswer": {
                        "@type": "Answer",
                        "text": "Comece pelo DB_HOST: o novo provedor pode usar 127.0.0.1 ou um host de banco dedicado em vez de 'localhost'. Depois confira usuário e senha do banco no painel da nova hospedagem.",
                        "author": {
                            "@id": "https://full.services/#org"
                        }
                    }
                }
            ]
        },
        {
            "@type": "HowTo",
            "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#howto",
            "name": "Como corrigir Error establishing a database connection",
            "inLanguage": "pt-BR",
            "isPartOf": {
                "@id": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#article"
            },
            "isAccessibleForFree": true,
            "step": [
                {
                    "@type": "HowToStep",
                    "position": 1,
                    "name": "Confirme as credenciais do banco",
                    "text": "Confirme as credenciais do banco: abra o wp-config.php via FTP e compare DB_NAME, DB_USER, DB_PASSWORD e DB_HOST com os dados do painel da hospedagem. Uma senha trocada recentemente é a causa nº 1.",
                    "url": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#secao-solucao"
                },
                {
                    "@type": "HowToStep",
                    "position": 2,
                    "name": "Verifique se o servidor de banco está no ar",
                    "text": "Verifique se o servidor de banco está no ar: entre no phpMyAdmin do painel. Se ele também não conectar, o problema é no servidor MySQL: contate o suporte da hospedagem.",
                    "url": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#secao-solucao"
                },
                {
                    "@type": "HowToStep",
                    "position": 3,
                    "name": "Teste o DB_HOST correto",
                    "text": "Teste o DB_HOST correto: se 'localhost' não conecta, troque por '127.0.0.1' ou pelo host de banco informado pelo provedor (comum em hospedagem com banco em servidor separado).",
                    "url": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#secao-solucao"
                },
                {
                    "@type": "HowToStep",
                    "position": 4,
                    "name": "Repare o banco de dados",
                    "text": "Repare o banco de dados: se o erro citar tabelas indisponíveis, adicione define('WP_ALLOW_REPAIR', true); ao wp-config.php e acesse seudominio.com/wp-admin/maint/repair.php. Remova a linha depois de reparar.",
                    "url": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#secao-solucao"
                },
                {
                    "@type": "HowToStep",
                    "position": 5,
                    "name": "Cheque o limite de conexões",
                    "text": "Cheque o limite de conexões: se o erro só aparece em picos, peça ao host para revisar max_connections do MySQL ou avalie subir de plano.",
                    "url": "https://full.services/wp-fixer/corrigir-erro-conexao-banco-dados-wordpress/#secao-solucao"
                }
            ],
            "description": "\"Error establishing a database connection\" significa que o WordPress não conseguiu falar com o MySQL. Quase sempre vem de credenciais erradas no wp-config.php, do servidor de banco fora do ar ou de tabelas corrompidas."
        }
    ]
}
```
