Como Resolver o Erro ao Gravar Cedilha no MySQL
O erro ao gravar ç no MySQL se resolve alinhando a codificação em toda a cadeia: arquivo da aplicação, página ou API, conexão com o banco, banco, tabela e coluna devem usar UTF-8, de preferência utf8mb4. Quando uma dessas partes usa outra codificação, a cedilha pode virar ç, ?, desaparecer ou ser salva com bytes incorretos. O diagnóstico começa identificando em qual etapa o texto muda, antes de alterar a estrutura do banco.
Use esta tabela para reconhecer o cenário mais provável.
| Sintoma | Causa mais provável | Correção inicial |
|---|---|---|
ç vira ç |
Texto UTF-8 foi interpretado como Latin-1 | Corrija a codificação da conexão, do arquivo e da resposta HTTP |
ç vira ? |
Coluna ou conexão não suporta os caracteres recebidos | Use um charset compatível na tabela e na conexão |
ç desaparece antes de chegar ao banco |
Sanitização, validação ou conversão no código | Inspecione o valor recebido pela aplicação antes do INSERT |
| Funciona no phpMyAdmin, mas falha na aplicação | A conexão da aplicação usa charset diferente | Configure o charset ao abrir cada conexão |
| Dados antigos aparecem corrompidos | Os bytes foram gravados ou importados com charset errado | Identifique a codificação real antes de converter a tabela |
Por Que a Cedilha Dá Erro no MySQL
A cedilha não é um caractere especial para o MySQL quando a aplicação usa Unicode corretamente. Em UTF-8, ç, ã, é e outros caracteres do português são armazenados normalmente.
O problema aparece quando o texto atravessa camadas que discordam sobre seus bytes. Por exemplo:
- O navegador envia
cançãoem UTF-8. - A aplicação ou conexão informa ao MySQL que recebeu Latin-1.
- O MySQL interpreta os bytes UTF-8 como se fossem Latin-1.
- O texto é gravado como
canção.
A correção duradoura não é “consertar a cedilha”, mas fazer todas as camadas declararem e usarem a mesma codificação.
Também é importante separar dois conceitos:
- Character set (charset): define como os caracteres são representados em bytes.
- Collation: define regras de comparação e ordenação para um charset, como diferenças entre maiúsculas, minúsculas e acentos.
Trocar apenas a collation não corrige uma conexão, um formulário ou um arquivo salvo com codificação errada.
Como Corrigir a Gravação de Cedilha no MySQL
Etapa 1: Faça Backup e Localize Onde o Texto Muda
- Faça um backup antes de converter tabelas ou colunas existentes. Uma conversão de charset pode preservar dados corretos, mas não recupera automaticamente textos que já foram gravados como
ç. - Teste o mesmo valor em cada etapa: formulário ou requisição, variável da aplicação, comando SQL e resultado da consulta.
- Use uma palavra que tenha mais de um caso relevante, como
ação, canção, coração e açúcar.
Se a aplicação recebe canção corretamente, mas o banco retorna canção, o problema normalmente está na conexão ou na definição da tabela. Se o valor já chega como canao antes do INSERT, procure filtros, regex, funções de normalização ou conversões aplicadas pelo código.
Etapa 2: Inspecione o Charset do Banco, da Tabela e da Conexão
Execute estas consultas no cliente MySQL usando o nome real do seu banco:
SHOW CREATE DATABASE `app`;
SHOW CREATE TABLE `app`.`clientes`;
SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';
Procure especialmente por estes pontos:
- O banco tem um charset padrão coerente com sua aplicação.
- A tabela não depende de um charset herdado inesperado.
- As colunas de texto, como
VARCHAR,TEXTeCHAR, usam o charset esperado. - A sessão da aplicação usa valores coerentes para
character_set_client,character_set_connectionecharacter_set_results.
O charset padrão do banco não altera automaticamente colunas que já existem. Uma tabela antiga pode continuar usando outra configuração mesmo depois de você mudar o padrão do banco.
Etapa 3: Defina o Charset do Esquema
Para um projeto novo, use utf8mb4 no banco e nas tabelas de texto. Ele cobre a cedilha, os demais caracteres Unicode e também caracteres fora do conjunto UTF-8 antigo do MySQL.
Um banco novo pode ser criado assim:
CREATE DATABASE app CHARACTER SET utf8mb4;
Em esquemas legados que exigem especificamente a configuração UTF-8 clássica, a definição SQL do banco usa default character set utf8 e default collate utf8_general_ci:
CREATE DATABASE app
DEFAULT CHARACTER SET utf8
DEFAULT COLLATE utf8_general_ci;
Para aplicações novas, prefira utf8mb4 a utf8. Para aplicações novas, utf8mb4 oferece uma opção mais ampla que utf8.
Se uma tabela existente contém texto válido e foi declarada com charset incorreto, você pode convertê-la após fazer backup:
ALTER TABLE clientes CONVERT TO CHARACTER SET utf8mb4;
Esse comando é apropriado quando os dados armazenados correspondem ao charset que a tabela declara atualmente. Não o use como tentativa aleatória de reparar textos já exibidos como ç; nesse caso, os bytes podem estar corrompidos ou ter sido interpretados de forma errada no passado.
Etapa 4: Configure o Charset da Conexão da Aplicação
A conexão é uma das causas mais comuns do erro. Não basta criar o banco com o charset certo: cada conexão aberta pela aplicação precisa informar ao MySQL como os textos serão enviados e recebidos.
Em PHP com PDO, inclua charset=utf8mb4 na string de conexão:
$pdo = new PDO(
'mysql:host=localhost;dbname=app;charset=utf8mb4',
$usuario,
$senha
);
Em PHP com MySQLi, defina o charset logo depois de abrir a conexão e antes de executar consultas:
$mysqli = new mysqli($host, $usuario, $senha, 'app');
$mysqli->set_charset('utf8mb4');
Se sua biblioteca não oferece configuração própria de charset, é possível definir a sessão SQL:
SET NAMES utf8mb4;
Use esse comando para configurar a sessão quando o driver não oferecer uma configuração própria de charset. Ainda assim, prefira a configuração nativa do driver, como o parâmetro do PDO ou set_charset(), porque ela deixa a intenção explícita no ponto em que a conexão é criada.
Evite aplicar funções de conversão de encoding em todo texto indiscriminadamente. Converter uma string que já está em UTF-8 pode produzir exatamente o defeito que você tenta eliminar.
Etapa 5: Alinhe Arquivos, HTML, Formulários e Respostas HTTP
Salve arquivos PHP, JavaScript, HTML e arquivos de importação no mesmo charset usado pela aplicação, normalmente UTF-8. A página entregue ao navegador também precisa declarar esse charset, pois o navegador usa essa informação ao codificar campos de formulário.
Em uma página moderna, declare UTF-8 dentro do elemento head:
<meta charset="UTF-8">
A resposta HTTP também deve informar UTF-8 quando a aplicação gera HTML ou JSON. Se o cabeçalho HTTP disser uma coisa e a meta tag disser outra, o navegador pode seguir o cabeçalho e enviar dados com uma codificação diferente da esperada.
Não misture a configuração acima com um projeto legado baseado em ISO-8859-1. Se toda a aplicação realmente usa ISO-8859-1, incluindo arquivos, cabeçalho HTTP, conexão e banco, a tag declarada no head é:
<meta http-equiv="content-Type" content="text/html; charset=iso-8859-1" />
Essa configuração só é adequada para uma aplicação legada integralmente em ISO-8859-1. Colocar essa tag em uma página cujos arquivos, conexão e banco usam UTF-8 cria um novo desencontro de codificação.
Quando Usar Latin1 e latin1_swedish_ci
Um banco legado pode usar latin1 e a collation latin1_swedish_ci. Na configuração de Collation do banco de dados, latin1_swedish_ci é uma opção histórica comum para bancos com charset Latin-1.
Exemplo de criação de banco legado:
CREATE DATABASE legado
DEFAULT CHARACTER SET latin1
COLLATE latin1_swedish_ci;
O nome swedish não significa que a tabela só aceitará sueco. Ele identifica regras de ordenação e comparação históricas associadas ao charset latin1.
Latin-1 consegue representar a cedilha e muitos caracteres usados em português. Porém, ele não cobre todo Unicode e não é a melhor escolha para um sistema novo, integrações externas, APIs JSON, importações variadas ou conteúdo que possa incluir emojis e outros alfabetos.
Use latin1_swedish_ci somente quando você precisa manter compatibilidade com um sistema legado já inteiro em Latin-1. Nesse cenário, a conexão também precisa usar Latin-1, e o HTML deve declarar ISO-8859-1. Não use banco em Latin-1 com aplicação, formulário e conexão em UTF-8 esperando que a collation faça a conversão automaticamente.
Como Corrigir Dados Que Já Foram Gravados Errados
Dados já corrompidos exigem mais cuidado do que uma configuração nova. O texto ç pode indicar que bytes UTF-8 foram lidos como Latin-1, mas também pode resultar de uma segunda conversão feita pelo código.
Comece examinando um registro de exemplo e seus bytes:
SELECT texto, HEX(texto)
FROM clientes;
Substitua clientes e texto pelos nomes reais. Compare o resultado com o valor original conhecido. Faça isso primeiro em uma cópia do banco ou em um backup restaurado para ambiente de teste.
Há três cenários comuns:
- Os dados aparecem corretos no banco, mas errados no site: corrija a conexão e a resposta HTTP; não altere os dados.
- Os dados aparecem como
çno banco: investigue a importação ou a conexão usada quando foram gravados. Uma conversão estrutural da tabela não necessariamente reverte esse texto. - A cedilha some antes de ser gravada: procure código que remove caracteres não ASCII, filtros de entrada, expressões regulares restritivas ou transformações como remoção de acentos.
Se você possui um dump anterior à corrupção, restaurar esse backup usando a codificação correta costuma ser a opção mais segura. Se não possui, corrija primeiro a configuração atual, escolha um conjunto pequeno de registros para recuperação e valide cada resultado antes de aplicar qualquer alteração em massa.
Como Confirmar Que a Cedilha Foi Corrigida
Depois de ajustar banco, conexão e saída da aplicação, teste a cadeia completa em um ambiente de desenvolvimento.
Crie uma tabela temporária de teste:
CREATE TABLE teste_charset (
texto TEXT
) CHARACTER SET utf8mb4;
Insira uma frase com caracteres do português:
INSERT INTO teste_charset (texto)
VALUES ('Ação, canção, coração, açúcar e ç');
Leia o valor e os bytes armazenados:
SELECT texto, HEX(texto)
FROM teste_charset;
Por fim, remova a tabela de teste:
DROP TABLE teste_charset;
A confirmação completa não termina no cliente SQL. Faça também este checklist:
- Envie o texto por um formulário ou pela mesma API usada pela aplicação.
- Confira o valor recebido no código antes da gravação.
- Consulte o registro diretamente no MySQL.
- Exiba o mesmo registro de volta no navegador ou consumidor da API.
- Recarregue a página e confirme que o texto continua idêntico.
Se o texto estiver correto no MySQL, mas errado apenas no navegador, o banco já está resolvido; reveja o charset da resposta HTTP, a meta tag e a codificação dos arquivos exibidos.
Como Evitar Novos Problemas de Codificação
Defina uma política única para o projeto: UTF-8 nos arquivos, utf8mb4 no banco, conexão configurada ao abrir o driver e respostas HTTP declaradas em UTF-8.
Inclua o charset nas migrations que criam bancos e tabelas. Não dependa apenas do padrão instalado no servidor, pois ele pode ser diferente entre desenvolvimento, testes e produção.
Centralize a criação de conexões em um único ponto da aplicação. Assim, a configuração de charset não fica esquecida em um script, job, fila ou endpoint antigo.
Também vale adicionar testes com palavras como ação, canção, maçã e coração em operações de criação, atualização, busca, exportação e importação. Um teste de regressão simples detecta rapidamente uma conexão aberta sem a configuração correta.
Depois de corrigir a configuração, faça um teste completo de envio, gravação, consulta e exibição com uma frase contendo ç e acentos. Se esse teste passar em todas as etapas, use a mesma configuração centralizada em todas as conexões e migrations do projeto.
Frequently Asked Questions
A collation sozinha resolve o erro da cedilha?
Não. A collation controla principalmente como o MySQL compara e ordena textos, enquanto o charset determina como os caracteres são armazenados em bytes. Para gravar ç corretamente, a coluna, a conexão e os dados enviados precisam usar charsets compatíveis.
Posso usar latin1_swedish_ci para gravar cedilha?
Sim, latin1_swedish_ci pode funcionar em um banco Latin-1 e suporta a cedilha. Ele faz sentido quando toda a aplicação legada usa ISO-8859-1 ou Latin-1, incluindo arquivos, HTML, conexão e banco. Para sistemas novos, utf8mb4 é uma escolha mais ampla e mais segura para Unicode.
Por que a cedilha vira ç?
ç normalmente indica que bytes UTF-8 foram interpretados usando Latin-1 ou outra codificação incompatível. O banco pode estar correto e o defeito estar na conexão, no cabeçalho HTTP, no arquivo de origem ou na ferramenta de importação.
Preciso executar SET NAMES utf8mb4 em toda consulta?
Não. O comando precisa ser aplicado uma vez por conexão, antes das consultas, caso seu driver não tenha uma configuração própria de charset. Em PDO, usar charset=utf8mb4 na conexão é preferível; em MySQLi, use set_charset('utf8mb4') logo após abrir a conexão.
Por que a cedilha desaparece, em vez de virar caracteres estranhos?
Quando a cedilha desaparece antes de chegar ao banco, a causa costuma ser código da aplicação, como filtros que aceitam apenas caracteres ASCII, regex restritivas ou funções que removem acentos. Uma coluna utf8mb4 armazena ç normalmente; inspecione o valor recebido pela aplicação antes do INSERT.
