Como diagnosticar charset incorreto no MySQL Print

  • 0

Como Diagnosticar Charset Incorreto no MySQL – Guia para Iniciantes

Olá, amigo(a) GeHost! Se você está lendo isso, provavelmente já percebeu que algum texto no seu site ou sistema está aparecendo com caracteres estranhos: á, ç, é, ô viram á, ç, é, ô ou até (um quadrado vazio).

Isso geralmente acontece por causa do charset incorreto no banco de dados MySQL. Não se preocupe — é um problema comum, e eu, seu Sensei da GeHost, vou te ajudar a resolver isso com calma, passo a passo. Vamos juntos?

🔍 O que é charset e por que ele importa?

Imagine o charset como o "alfabeto" que o MySQL usa para entender e salvar os caracteres. Se o banco está usando um alfabeto errado (como latin1 em vez de utf8mb4), ele não consegue ler corretamente letras acentuadas ou emojis.

Dica do Sensei: O padrão ideal hoje em dia é utf8mb4 — ele suporta todos os caracteres, inclusive emojis. Use sempre isso!

✅ Passo a Passo: Como Diagnosticar o Charset Incorreto

  1. Entre no cPanel com suas credenciais. Se não souber como, é só acessar seudominio.com.br/cpanel e logar com seu usuário e senha.

    Tela de LOGIN do cPanel com campos Usuário e Senha + botão Log in
  2. Depois de logado, procure pela ferramenta MySQL Databases — ela está no grupo Banco de Dados. Clique nela.

    Painel inicial (home) do cPanel com os grupos de ferramentas (E-mail, Arquivos etc.)
  3. Na tela de Bancos de Dados MySQL, você verá uma lista com os bancos já criados. Clique no link “Ver detalhes” ou o nome do banco que está com problema.

    Tela 'Bancos de Dados MySQL' — criar novo banco, modificar e usuários de banco
  4. Na página de detalhes do banco, procure por uma seção chamada “Charset” ou “Collation”. Aqui você verá qual é o conjunto de caracteres atualmente configurado.

    Se estiver em latin1, cp1252 ou algo semelhante, é isso: o charset está errado.

    Se estiver em utf8mb4, parabéns! Você já está no caminho certo. 🎉

  5. Se o charset estiver incorreto, não mude diretamente no cPanel. Isso pode causar danos. Em vez disso, use um script SQL para verificar e corrigir.

    Para isso, vamos usar o phpMyAdmin — uma ferramenta de administração do MySQL que vem no cPanel.

  6. Volte ao cPanel e clique em phpMyAdmin (no mesmo grupo de ferramentas).

    Selecione o banco de dados com problema na lista à esquerda.

    Na parte superior, clique em “Estrutura” (ou “Structure”) para ver todas as tabelas.

  7. Na lista de tabelas, clique em “Editar” (ícone de lápis) em uma tabela que contenha texto acentuado.

    Na aba “Opções de tabela” (ou “Table options”), verifique o campo “Collation”.

    Se estiver como latin1_swedish_ci ou similar, está errado. Deve ser utf8mb4_unicode_ci ou utf8mb4_general_ci.

  8. Se encontrar um problema, use o SQL para verificar o estado real do banco:

    Na parte superior do phpMyAdmin, clique em “SQL”.

    Insira este comando:

    SHOW CREATE DATABASE nome_do_seu_banco;
        

    Substitua nome_do_seu_banco pelo nome real do seu banco (ex: meubanco).

    Se a saída mostrar DEFAULT CHARSET=latin1, então o problema está confirmado.

  9. Se o problema for confirmado, o mais seguro é corrigir via SQL. Vamos alterar o charset do banco:

    ALTER DATABASE nome_do_seu_banco CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
        

    Depois, corrigimos as tabelas:

    ALTER TABLE nome_da_tabela CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
        

    Repita esse comando para cada tabela que contém texto acentuado.

⚠️ Cuidado com os arquivos do seu site!

Se o banco está com charset errado, mas o código do seu site (PHP, WordPress, etc.) está tentando salvar dados em utf8, pode haver desalinhamento. Verifique também:

  • Se seu arquivo config.php ou wp-config.php tem a linha: define('DB_CHARSET', 'utf8mb4');
  • Se o arquivo de conexão com o banco define o charset como utf8mb4.

✅ Conclusão: Você está no caminho certo!

Diagnosticar charset incorreto no MySQL pode parecer assustador, mas agora você sabe que é só uma questão de verificar o conjunto de caracteres no banco e nas tabelas. O mais importante é manter tudo em utf8mb4 — o padrão moderno e seguro.

Sensei diz: “A paciência é a chave. Um bom charset evita problemas de texto, acentos e até erros de segurança. Cuidar disso é cuidar do seu site!”

Se precisar de ajuda com o SQL ou tiver dúvidas sobre como aplicar essas correções no seu sistema, é só chamar a nossa equipe de suporte. Estamos aqui para te ajudar, sempre.

Com carinho, seu Sensei da GeHost 💚


Was this answer helpful?

« Back