Renomear banco de dados no cPanel sem quebrar o site
O painel renomeia em segundos e não avisa nada. Quem reclama é o WordPress, com a tela de erro de conexão, porque o wp-config.php ainda aponta para o nome antigo.

Resposta curta: renomear o banco no cPanel é seguro com backup antes e 4 passos: colocar o site em manutenção (opcional), usar o botão Rename em Bancos de Dados MySQL, atualizar DB_NAME no wp-config.php e reassociar o usuário com ALL PRIVILEGES. Sem o DB_NAME novo, o WordPress mostra erro de conexão com o banco.
Neste artigo
- O que o botão Rename faz e o que ele não faz
- Como identificar o banco certo quando a conta tem vários sites
- Backup antes, sem exceção
- A ordem dos passos que mantém o site fora do ar por segundos, não por minutos
- Renomear o usuário é outra operação, e quase sempre desnecessária
- Por que o erro aparece como mensagem do WordPress, e não do cPanel
- Três níveis de reversão, do mais barato ao mais caro
- O que confirmar antes de fechar o painel
Renomear um banco de dados no cPanel leva poucos segundos. O site cai no mesmo instante, porque o WordPress continua procurando o nome antigo no wp-config.php e recebe um erro do MySQL. A tela que aparece não é um aviso do painel: é a mensagem do próprio WordPress, Erro ao estabelecer conexão com o banco de dados.
A operação é segura quando feita na ordem certa. Fora de ordem, ela custa minutos de site fora do ar e uma reassociação de usuário que muita gente esquece.
O que o botão Rename faz e o que ele não faz
No cPanel, a ferramenta MySQL Databases (Bancos de Dados MySQL) tem, na lista de bancos existentes, uma ação Rename ao lado de cada banco. Segundo a documentação oficial do cPanel, a interface permite renomear bancos e usuários existentes, além de criar, remover e gerenciar privilégios.
O que o Rename faz:
- Muda o nome do banco no servidor MySQL, mantendo as tabelas e os dados.
- Mantém o prefixo da conta cPanel (algo como
usuario_antes do nome que você escolhe).
O que ele não faz:
- Não altera o
wp-config.phpnem qualquer arquivo do seu site. - Não avisa que existe um site apontando para aquele banco.
- Não garante que o usuário do banco continue com os mesmos privilégios no nome novo. Por isso o passo de reassociar existe neste guia.
Em bancos grandes a operação pode demorar alguns segundos a mais: espere a página recarregar e não feche a aba no meio do processo.
Como identificar o banco certo quando a conta tem vários sites
Em conta com vários sites, renomear o banco errado é o acidente mais comum. Faça a conferência pelos dois lados.
O wp-config.php é a palavra final sobre qual banco o site usa
No Gerenciador de Arquivos do cPanel, entre na pasta do site (normalmente public_html ou public_html/pasta-do-site), clique com o botão direito em wp-config.php e escolha Editar. Procure a linha:
define( 'DB_NAME', 'usuario_wp01' );
define( 'DB_USER', 'usuario_wpuser' );
define( 'DB_PASSWORD', 'senha-atual' );
define( 'DB_HOST', 'localhost' );
O valor de DB_NAME é o banco que você vai renomear. Anote também DB_USER: é o usuário que precisará ser reassociado depois.
Como confirmar o banco pela lista Current Databases do cPanel
Em Bancos de Dados MySQL, a lista Current Databases mostra, para cada banco, o tamanho e os usuários com privilégio. Use as duas colunas como confirmação cruzada:
| Sinal na lista | O que ele indica |
|---|---|
Nome igual ao DB_NAME |
É o banco do site, confirmado |
Usuário associado igual ao DB_USER |
Confirmação dupla, pode seguir |
| Tamanho muito pequeno | Pode ser banco de teste ou instalação abandonada |
| Nenhum usuário associado | Banco órfão, provavelmente não é o do site no ar |
Se dois bancos tiverem nomes parecidos (usuario_wp e usuario_wp2), o wp-config.php é a palavra final.
Backup antes, sem exceção
Renomear mexe na estrutura inteira do banco. Se a operação for interrompida, você quer ter um arquivo para restaurar.
Baixar o dump pela ferramenta Backup do cPanel
- Abra Backup (Backups) no painel.
- Na seção Download a MySQL Database Backup, clique no nome do banco.
- O navegador baixa um arquivo
.sql.gz. Guarde fora do servidor.
Exportar o banco pelo phpMyAdmin
- Abra phpMyAdmin.
- Clique no banco na coluna da esquerda.
- Aba Exportar, método Rápido, formato SQL, botão Executar.
Faça também um backup dos arquivos, ou ao menos uma cópia do wp-config.php. No Gerenciador de Arquivos: botão direito no arquivo, Copiar, e salve como wp-config.php.bak na mesma pasta. Esse arquivo é o seu caminho de volta se você errar uma aspa na edição.
A ordem dos passos que mantém o site fora do ar por segundos, não por minutos
O site vai ficar indisponível entre o passo 2 e o passo 3. Faça os dois em sequência, com as duas abas já abertas. O backup da seção anterior já deve estar baixado antes de começar: ele não entra na contagem porque não é opcional.
Modo manutenção evita que o visitante veja o erro
Opcional, mas evita que visitantes vejam o erro de conexão. Um plugin de modo manutenção resolve. Se não tiver, apenas escolha um horário de pouco acesso.
Renomeando o banco sem perder o prefixo da conta
- Em Bancos de Dados MySQL, encontre o banco na lista Current Databases.
- Clique em Rename na linha dele.
- Digite o nome novo. Lembre que o prefixo da conta é mantido automaticamente: você digita só a parte final.
- Confirme e espere a página recarregar. Não feche a aba.
Use apenas letras minúsculas, números e sublinhado. Evite hífen e acento.
Trocando o DB_NAME no wp-config.php pelo nome novo
- Volte ao Gerenciador de Arquivos, abra
wp-config.phpem Editar. - Troque o valor de
DB_NAMEpelo nome novo completo, com prefixo:
define( 'DB_NAME', 'usuario_wpnovo' );
- Salve. Atenção às aspas simples e ao ponto e vírgula no fim da linha.
- Abra o site em aba anônima e recarregue.
Se o site voltar, falta apenas a verificação de privilégios do passo seguinte. Se não voltar, vá direto para a seção de erros.
Reassociando o usuário com ALL PRIVILEGES
Na própria tela Bancos de Dados MySQL, role até Current Databases e olhe a coluna de usuários privilegiados do banco renomeado. Se o usuário do site não estiver lá:
- Vá até a seção Add User To Database.
- Escolha o usuário em User e o banco novo em Database.
- Clique em Add.
- Na tela Manage User Privileges, marque ALL PRIVILEGES e confirme.
O WordPress precisa de privilégios amplos no banco para atualizar o próprio núcleo, instalar plugins e criar tabelas. Conceder só SELECT faz o site abrir e quebrar na primeira escrita.
Renomear o usuário é outra operação, e quase sempre desnecessária
A mesma tela permite renomear usuários MySQL. A documentação do cPanel trata usuários e bancos como objetos separados, com gerenciamento de privilégios próprio entre eles.
Consequência prática: o privilégio é um vínculo entre um usuário e um banco. Quando o nome de um dos dois muda, o vínculo pode deixar de existir e precisa ser refeito em Add User To Database. Depois de renomear o usuário, você ainda tem que:
- Atualizar
DB_USERnowp-config.phpcom o nome novo, incluindo o prefixo. - Reassociar o usuário ao banco com ALL PRIVILEGES.
A senha não muda ao renomear o usuário, então DB_PASSWORD continua válida. Se você não tem certeza da senha, defina uma nova em Change Password na seção de usuários e atualize o wp-config.php com ela.
Recomendação contra o óbvio: na maioria das migrações, não renomeie o usuário. Renomeie só o banco. Um passo a menos é uma chance a menos de quebrar.
Por que o erro aparece como mensagem do WordPress, e não do cPanel
O cPanel considera a renomeação bem-sucedida assim que o MySQL responde. Ele não conhece seus arquivos PHP. Quem descobre o problema é o WordPress, na primeira requisição: ele lê DB_NAME, tenta conectar, o MySQL responde que aquele banco não existe ou que o usuário não tem acesso, e o WordPress imprime a tela de erro genérica.
Por isso a mensagem é sempre a mesma para causas diferentes. Use esta tabela para separar:
| Sintoma | Causa provável | Correção |
|---|---|---|
| Erro ao estabelecer conexão logo após o Rename | DB_NAME ainda com o nome antigo |
Atualize DB_NAME com o nome novo e prefixo |
Erro mesmo com DB_NAME correto |
Usuário sem privilégio no banco novo | Add User To Database com ALL PRIVILEGES |
| Site abre, mas plugin ou atualização falha ao gravar | Privilégio parcial, sem INSERT/UPDATE/CREATE | Refaça os privilégios marcando ALL PRIVILEGES |
| Tela branca em vez da mensagem de erro | Erro de sintaxe no wp-config.php |
Restaure wp-config.php.bak e refaça a edição |
Erro só no /wp-admin |
Cache de objeto ou plugin de cache com dados antigos | Renomeie a pasta do plugin de cache em wp-content/plugins |
Para ver o erro real em vez da mensagem genérica, ative o log temporariamente no wp-config.php, acima da linha que diz para parar de editar:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
O WordPress grava em wp-content/debug.log. Abra pelo Gerenciador de Arquivos, leia a última linha, corrija e desative o debug depois, voltando os valores para false. Deixar ligado expõe caminhos do servidor.
Três níveis de reversão, do mais barato ao mais caro
Se algo der errado e você precisar desfazer, existem três níveis de reversão. Comece pelo mais barato.
Desfazer o Rename e voltar o DB_NAME junto
Renomeie o banco de volta para o nome antigo pela mesma tela. Se você já tinha alterado o DB_NAME no passo 3, volte o valor para o nome antigo também: os dois precisam bater. Confirme a associação do usuário depois, porque ela pode ter se perdido na ida e na volta.
Restaurar o wp-config.php sem apagar a versão quebrada
Se a edição do arquivo quebrou o site (tela branca, erro de sintaxe), não apague nada. No Gerenciador de Arquivos, renomeie o wp-config.php atual para wp-config.php.ruim e só então renomeie wp-config.php.bak para wp-config.php. Assim você mantém as duas cópias das credenciais caso o .bak esteja incompleto ou desatualizado. Com o site de volta, confira se o .bak restaurado tem senha e usuário corretos, compare com o .ruim se precisar, e refaça a alteração com calma, uma linha só.
Importar o dump em um banco novo
Se o banco ficou inconsistente, crie um banco novo em Bancos de Dados MySQL, associe o usuário com ALL PRIVILEGES, entre no phpMyAdmin, selecione o banco novo, aba Importar, envie o .sql do backup e aponte DB_NAME para ele. Esse é o motivo de o backup vir antes de tudo.
O que confirmar antes de fechar o painel
Antes de fechar o painel, confirme na ordem:
DB_NAMEnowp-config.phpbate exatamente com o nome que aparece na lista do cPanel, prefixo incluído.DB_USERaparece na coluna de usuários privilegiados daquele banco.- O usuário tem ALL PRIVILEGES.
- O site abre em aba anônima.
- O
/wp-adminabre e você consegue salvar uma alteração qualquer, por exemplo o título do site em Configurações, Geral. Isso prova que a escrita funciona. - Debug desativado e backup guardado fora do servidor.
- Se o site usa cache, limpe o cache do plugin e do servidor.
Um detalhe que só aparece depois: instalações que guardam credenciais fora do wp-config.php. Alguns plugins de backup, de busca externa ou de staging gravam o nome do banco em arquivos de configuração próprios. Se algo específico parar de funcionar dias depois da renomeação, procure o nome antigo dentro de wp-content pela busca do Gerenciador de Arquivos.
Fonte consultada para o comportamento da interface e para o gerenciamento de bancos, usuários e privilégios: cPanel, Manage My Databases, consultado em 18 de outubro de 2026. Os nomes usuario_wp01 e usuario_wpnovo usados aqui são exemplos fictícios; o prefixo real é o da sua conta.
Referências
- Documentação oficial (cpanel) — Manage My Databases. Consultado em 2026-10-18.