# 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.

> 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.

João Rizzon · 2026-10-23 · Painéis

---

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](https://docs.cpanel.net/cpanel/databases/manage-my-databases/), 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.php` nem 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:

```php
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.php` em **Editar**.
- Troque o valor de `DB_NAME` pelo nome novo completo, com prefixo:

```php
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_USER` no `wp-config.php` com 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:

```php
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_NAME` no `wp-config.php` bate exatamente com o nome que aparece na lista do cPanel, prefixo incluído.
- `DB_USER` aparece na coluna de usuários privilegiados daquele banco.
- O usuário tem ALL PRIVILEGES.
- O site abre em aba anônima.
- O `/wp-admin` abre 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](https://docs.cpanel.net/cpanel/databases/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.

