blog
Revenda

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.

JR · · 8 min de leitura · 1 tabela · 5 blocos de código

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
  1. O banco não sumiu, o mapa de propriedade sumiu
  2. Prove que o dado está lá antes de tocar em qualquer coisa
  3. Como o cPanel decide o que mostrar na tela MySQL Databases
  4. Reconstruir a propriedade pelo Database Map Tool do WHM
  5. O prefixo da conta é o que mais derruba a correção
  6. Validar a conexão com o usuário da aplicação, sem recriar nada
  7. Checklist de pré-migração para padronizar na carteira
  8. 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:

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

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

  1. Documentação oficial (cpanel) — Database Map Tool. Consultado em 2026-09-29.
Leia também