# Banco não aparece no cPanel depois da migração de servidor

O dado está em disco e o site pode até estar no ar. O que quebrou foi o mapa de propriedade entre banco, usuário e conta. Como provar isso, reconstruir e validar sem recriar nada.

> o banco continua no servidor, o que sumiu é o registro de propriedade (dbmap) que liga banco, usuário e conta cPanel. Prove que o dado existe com SHOW DATABASES, tire um dump e refaça o mapa pelo Database Map Tool do WHM. Nunca recrie o banco por cima.

João Rizzon · 2026-10-07 · Revenda

---

## O banco não sumiu, o mapa de propriedade sumiu

O cliente abre **cPanel > MySQL Databases** e a lista está vazia. O site, em alguns casos, ainda responde. Em outros, mostra o erro de conexão do WordPress. A agência entra em pânico, cria um banco novo com o mesmo nome e importa um dump velho. Aí sim o dado se perde.

O que normalmente aconteceu é mais chato e menos grave: o banco continua em disco, dentro do diretório de dados do MySQL/MariaDB, e aparece no phpMyAdmin acessado pelo WHM (visão de root). O que não existe é o registro de **propriedade**: a relação que diz ao cPanel que o banco `X` e o usuário `Y` pertencem à conta `Z`. O cPanel chama esse registro de **database map** (dbmap). A tela MySQL Databases não lê o servidor MySQL inteiro, ela lê o mapa da conta. Mapa vazio, tela vazia.

Isso costuma acontecer em três situações: migração manual (rsync do diretório de dados ou dump importado como root), restauração parcial de backup, e mudança de nome de usuário da conta cPanel, que muda o prefixo esperado dos bancos.

## Prove que o dado está lá antes de tocar em qualquer coisa

Regra de ouro: **nenhuma ação de escrita antes da prova de existência**. Com acesso root por SSH, três comandos resolvem.

```bash
# 1. O banco existe no servidor?
mysql -e "SHOW DATABASES LIKE 'cliente_wp%';"

# 2. Tem tabelas e linhas, ou é uma casca vazia?
mysql -e "SELECT table_name, table_rows \
  FROM information_schema.tables \
  WHERE table_schema='cliente_wp' ORDER BY table_rows DESC LIMIT 10;"

# 3. Quais usuários MySQL têm grant nesse banco?
mysql -e "SELECT user, host FROM mysql.db WHERE db='cliente_wp';"
```

`cliente_wp` é exemplo. Troque pelo nome real.

Se o passo 2 devolver `wp_posts`, `wp_options` e companhia com contagem compatível, o conteúdo está no servidor. Em InnoDB, `table_rows` é estimativa, não contagem exata: serve para distinguir "tem dado" de "está vazio", não para auditoria.

Antes de qualquer correção, tire um dump. Dois minutos que evitam uma noite ruim:

```bash
mysqldump --single-transaction --routines --triggers \
  cliente_wp > /root/pre-fix-cliente_wp.sql
```

## Como o cPanel decide o que mostrar na tela MySQL Databases

Três coisas precisam bater, e elas são independentes entre si:

| Camada | Onde vive | Sintoma quando falta |
|---|---|---||
| O banco | Diretório de dados do MySQL/MariaDB | Nem no phpMyAdmin do WHM aparece |
| O grant | Tabelas de privilégio do MySQL (`mysql.db`, `mysql.user`) | Site cai com erro de acesso negado |
| O mapa (dbmap) | Registro de propriedade da conta no cPanel | Banco existe, site pode até funcionar, mas a tela do cliente fica vazia |

O caso deste artigo é a terceira linha. O site às vezes continua no ar porque o `wp-config.php` guarda usuário e senha que ainda têm grant válido no MySQL. O WordPress conecta direto, sem passar pelo cPanel. O painel é que não sabe de nada.

É por isso que "o site funciona mas o banco não aparece" não é contradição. São duas camadas diferentes.

## Reconstruir a propriedade pelo Database Map Tool do WHM

O WHM tem uma ferramenta específica para isso: **Database Map Tool**, em SQL Services. Segundo a [documentação oficial do cPanel](https://docs.cpanel.net/whm/sql-services/database-map-tool/), ela permite selecionar uma conta cPanel e associar a ela bancos e usuários MySQL ou PostgreSQL que já existem no servidor. A seleção é feita por item na própria tela: o nome do banco não precisa seguir o prefixo da conta para ser associado.

### Identificar o nome da conta cPanel, que não é o domínio

Não é o nome do domínio, é o nome da conta. Confirme antes, porque a ferramenta trabalha por conta:

```bash
whmapi1 accountsummary user=cliente
```

### Marcar o banco e o usuário certos sem roubar o banco de outra conta

No WHM, abra **SQL Services > Database Map Tool**. A primeira tela pede a conta cPanel: escolha pelo nome de usuário da conta, não pelo domínio. Em seguida a ferramenta lista os bancos e os usuários de banco existentes no servidor, com caixas de seleção.

Marque o banco do cliente e o usuário de banco que a aplicação usa (o do `wp-config.php`). Deixe desmarcado qualquer banco que pertença a outra conta: associar errado tira o banco do dono atual. Salve.

O retorno esperado é uma mensagem de sucesso confirmando que o mapa da conta foi atualizado. Se a tela devolver erro, leia o texto: geralmente é banco já mapeado em outra conta (desassocie lá primeiro) ou usuário de banco inexistente no MySQL.

Se a conta não aparecer na lista de contas, ela não existe no WHM com aquele nome. Confira com `whmapi1 listaccts | grep -i cliente` e use o nome exato retornado. Se o banco não aparecer na listagem, ele não está no servidor: volte ao `SHOW DATABASES` do início, porque o problema deixou de ser mapa.

### Conferir entrando no cPanel como o cliente, não pelo WHM

Entre no cPanel da conta (via WHM, "Log in as user") e abra MySQL Databases. O banco deve estar listado, com o tamanho e os usuários associados.

### Quando o banco volta mas a coluna de usuários fica vazia

Acontece de o banco aparecer e a coluna de usuários privilegiados ficar vazia. Nesse caso, o usuário MySQL existe mas não foi associado. Na própria tela MySQL Databases, em **Add User To Database**, selecione o usuário e o banco, conceda **ALL PRIVILEGES** e salve. O grant no MySQL é reescrito e o mapa passa a registrar a associação.

## O prefixo da conta é o que mais derruba a correção

O cPanel prefixa bancos e usuários com o nome da conta mais underscore. Conta `cliente`, banco `cliente_wp`, usuário `cliente_wpuser`.

Quando a migração muda o nome da conta (de `agenciax` para `cliente`, por exemplo), o banco antigo continua chamado `agenciax_wp`. Ele não bate com o padrão da conta nova. Isso não impede a associação: no Database Map Tool você marca `agenciax_wp` e o usuário `agenciax_wpuser` para a conta `cliente` e o mapa volta normalmente. O problema é de padronização, não de impossibilidade.

Duas saídas:

- **Renomear para o prefixo novo.** Na tela MySQL Databases do cPanel existe a ação de renomear banco e renomear usuário. Renomeie `agenciax_wp` para `cliente_wp` e `agenciax_wpuser` para `cliente_wpuser`, depois atualize o `wp-config.php`. Não é obrigatório para o mapa voltar, é a opção limpa: a conta passa a ser portável para qualquer migração futura.
- **Manter o nome e ajustar a propriedade.** Dá menos trabalho imediato, mas você carrega a inconsistência para a próxima migração, e o backup/restore do WHM pode esbarrar nela de novo.

Para carteira de sites, padronize na opção 1. O custo é uma linha no `wp-config.php` e some uma classe inteira de chamado futuro.

## Validar a conexão com o usuário da aplicação, sem recriar nada

Com o mapa refeito, valide pelo mesmo caminho que o WordPress usa. Leia as credenciais reais do arquivo, não as que você lembra:

```bash
grep -E "DB_NAME|DB_USER|DB_HOST" /home/cliente/public_html/wp-config.php
```

Teste o login como o usuário da aplicação, não como root:

```bash
mysql -u cliente_wpuser -p -h localhost cliente_wp -e "SELECT option_value \
  FROM wp_options WHERE option_name='siteurl';"
```

Se devolver a URL do site, acabou: conexão, grant e dado conferidos de uma vez. Se devolver acesso negado, o problema é senha ou grant, não mapa. Nesse caso, redefina a senha pela tela MySQL Databases e cole o valor novo em `DB_PASSWORD`, com atenção a aspas e caracteres especiais.

Se o prefixo das tabelas não for `wp_`, confira `$table_prefix` no `wp-config.php` antes de rodar a consulta.

## Checklist de pré-migração para padronizar na carteira

Rode isto antes de mover qualquer site. Ele existe para que você nunca mais precise do resto deste artigo.

- Anotar nome da conta cPanel de origem e de destino, e comparar. Nome diferente significa prefixo diferente.
- Listar bancos, usuários e grants de cada conta antes de migrar, e guardar a saída junto do backup.
- Preferir o backup/restore nativo do WHM ao rsync do diretório de dados: o pacote de conta carrega o mapa de propriedade junto.
- Gerar dump lógico por banco (`mysqldump --single-transaction`) como segunda cópia, mesmo quando o pacote de conta já existe.
- Depois de restaurar, abrir o cPanel **como o cliente** e conferir MySQL Databases. Validar pelo WHM esconde justamente o erro de mapa.
- Testar a conexão com o usuário da aplicação, não com root.
- Registrar no checklist do projeto o nome final do banco e do usuário, com prefixo.
- Só então apontar DNS.

Os quatro primeiros itens custam minutos. O item que mais salva é o quinto: o mapa quebrado só é visível pelo painel do cliente.

## A frase pronta para explicar ao cliente o que aconteceu

Quando o cliente liga assustado, ele não quer o conceito de dbmap. Quer saber se perdeu o trabalho. Use algo assim:

> **** "Seus dados estão todos no servidor, nada foi apagado. O que aconteceu é que a lista de bancos do seu painel perdeu a referência de qual conta é dona do banco durante a mudança de servidor. É um índice, não o conteúdo. Vamos refazer essa referência e a lista volta a aparecer com tudo no lugar, sem restaurar backup."

E o aviso que vale repetir internamente para toda a equipe: **se o banco não aparece na tela do cliente, a primeira ação nunca é criar um banco com o mesmo nome**. O cPanel costuma recusar a criação de um banco com nome já existente, com erro de banco duplicado. Quem destrói dado é o passo seguinte: importar um dump antigo sobre as tabelas que estão lá, porque o dump derruba e recria cada tabela. Prove a existência, tire o dump, refaça o mapa.

