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.

Resposta curta: 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.
Neste artigo
- O banco não sumiu, o mapa de propriedade sumiu
- Prove que o dado está lá antes de tocar em qualquer coisa
- Como o cPanel decide o que mostrar na tela MySQL Databases
- Reconstruir a propriedade pelo Database Map Tool do WHM
- O prefixo da conta é o que mais derruba a correção
- Validar a conexão com o usuário da aplicação, sem recriar nada
- Checklist de pré-migração para padronizar na carteira
- A frase pronta para explicar ao cliente o que aconteceu
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.
# 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:
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, 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:
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_wpparacliente_wpeagenciax_wpuserparacliente_wpuser, depois atualize owp-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:
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:
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:
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.
Referências
- Documentação oficial (cpanel) — Database Map Tool. Consultado em 2026-09-29.