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:

  1. O navegador envia canção em UTF-8.
  2. A aplicação ou conexão informa ao MySQL que recebeu Latin-1.
  3. O MySQL interpreta os bytes UTF-8 como se fossem Latin-1.
  4. 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

  1. 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 ç.
  2. Teste o mesmo valor em cada etapa: formulário ou requisição, variável da aplicação, comando SQL e resultado da consulta.
  3. 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, TEXT e CHAR, usam o charset esperado.
  • A sessão da aplicação usa valores coerentes para character_set_client, character_set_connection e character_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.