Erro 1048 MySQL: Column cannot be null, como resolver
Entenda o erro 1048 do MySQL, a mensagem Column cannot be null, e veja quando ele aparece, como conferir a tabela e as formas de corrigir.
Por Redação Eleven Host · @robson.direitodigital · 4 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: Erro 1048 MySQL: Column cannot be null, como resolver Arte: Eleven Host
O erro 1048 MySQL, Column cannot be null, aparece quando uma instrução tenta gravar NULL numa coluna declarada como NOT NULL. Veja quando isso acontece, como conferir a tabela e as formas de corrigir.
Atualizado em 04/11/2026, com base no manual do MySQL 8.4. Na tela do cliente de linha de comando, o erro aparece assim, como no exemplo do próprio manual:
ERROR 1048 (23000): Column 'id' cannot be null
O que a mensagem do erro 1048 diz
Segundo a referência de erros do manual do MySQL 8.4, o código 1048 tem o símbolo ER_BAD_NULL_ERROR e o SQLSTATE 23000. O texto é Column '%s' cannot be null, e o %s vira o nome da coluna. Na linha acima, id é a coluna que recebeu o NULL.
Ou seja, a coluna foi criada com NOT NULL e a instrução tentou colocar NULL nela.
No MySQL 8.4, o modo SQL padrão inclui o STRICT_TRANS_TABLES. No modo estrito, o NULL numa coluna NOT NULL vira erro em vez de ser trocado pelo padrão implícito do tipo da coluna.
Quando o erro 1048 aparece
O manual, na seção sobre modos SQL, traz este exemplo. A coluna é NOT NULL e um dos valores do INSERT é NULL:
CREATE TABLE t2 (id INT NOT NULL);
INSERT INTO t2 (id) VALUES(1),(NULL),(3);
ERROR 1048 (23000): Column 'id' cannot be null
SELECT * FROM t2;
Empty set (0.00 sec)
A instrução inteira foi abortada e a tabela ficou vazia, inclusive sem os valores 1 e 3. Em tabelas transacionais, o manual diz que, com o modo estrito ligado (STRICT_ALL_TABLES ou STRICT_TRANS_TABLES), a instrução é abortada e desfeita.
Sem o modo estrito, o mesmo INSERT grava as linhas 1, 0 e 3: o NULL vira o padrão implícito do tipo da coluna, que é 0 para números. Segundo o manual do INSERT, o padrão implícito é 0 nos tipos numéricos, a string vazia nos tipos de texto e o valor zero nos tipos de data e hora.
INSERT de uma linha, de várias linhas e UPDATE
O manual do INSERT separa dois casos. Num INSERT de uma linha só, colocar NULL numa coluna NOT NULL não gera aviso: o comando falha com erro. Em um INSERT de várias linhas ou em um INSERT INTO ... SELECT, fora do modo estrito, a coluna recebe o padrão implícito. O INSERT ... SELECT segue a regra das várias linhas. Em modo estrito, como o exemplo acima mostrou, a instrução de várias linhas também dá o erro 1048.
No UPDATE, o manual diz que colocar NULL numa coluna NOT NULL gera erro se o modo estrito estiver ligado. Caso contrário, a coluna recebe o padrão implícito do tipo e o contador de avisos aumenta.
Em tabelas não transacionais, quando o valor ruim está da segunda linha em diante, o resultado depende do modo SQL e do motor da tabela. Por isso, confira o modo e o motor antes de assumir se as primeiras linhas foram gravadas.
Colunas em que o NULL não dá erro
Em colunas com AUTO_INCREMENT, o manual diz que inserir NULL em coluna inteira ou de ponto flutuante grava o próximo número da sequência, mesmo que a coluna seja NOT NULL.
O TIMESTAMP depende da variável explicit_defaults_for_timestamp. Segundo o manual, o valor padrão dela é ON, ela é dinâmica e está descontinuada. Com ela ligada, uma coluna TIMESTAMP NOT NULL não aceita NULL, e inserir NULL numa linha única em modo estrito dá erro. Com ela desligada, atribuir NULL grava a data e a hora atuais. Para gravar a hora atual com a variável ligada, o manual manda usar CURRENT_TIMESTAMP ou um sinônimo como NOW(). Esse comportamento do NULL virar hora atual vale só para TIMESTAMP, e não para DATETIME.
Erro 1048 x erro 1364
Os dois erros se parecem, e a diferença está na situação. O 1048 tem a mensagem Column '%s' cannot be null e o SQLSTATE 23000. O 1364 tem o símbolo ER_NO_DEFAULT_FOR_FIELD, o SQLSTATE HY000 e a mensagem Field '%s' doesn't have a default value. O guia do erro 1364 MySQL (campo sem valor padrão) trata o segundo em detalhe.
O manual define valor ausente assim: uma linha nova não traz valor para uma coluna que não aceita NULL e não tem cláusula DEFAULT explícita. Em resumo, no 1048 o NULL foi enviado, e no 1364 a coluna ficou sem valor.
Um exemplo de tabela, não testado, para ver os dois erros:
CREATE TABLE clientes (id INT PRIMARY KEY, email VARCHAR(100) NOT NULL);
INSERT INTO clientes (id, email) VALUES (1, NULL); -- erro 1048
INSERT INTO clientes (id) VALUES (2); -- erro 1364 em modo estrito
Como conferir a tabela e o modo SQL
Antes de corrigir, descubra qual coluna recusou o NULL e como ela foi definida. O nome da coluna está na própria mensagem. O manual descreve estes recursos:
DESCRIBEmostra a estrutura da tabela, e a colunaNullvaleYESse a coluna aceita NULL eNOse não aceita;SHOW CREATE TABLEmostra o comando de criação da tabela e deixa ver quais colunas têm cláusulaDEFAULTexplícita;- as consultas abaixo mostram o
sql_modeglobal e o da sessão; SHOW WARNINGSmostra erros, avisos e notas da última instrução na sessão, o que ajuda a ver o que o modo não estrito ajustou.
A coluna Default do SHOW COLUMNS pode confundir quando a coluna é NOT NULL e não tem padrão. Nesse caso, prefira o SHOW CREATE TABLE. Um exemplo de comandos para adaptar:
DESCRIBE clientes;
SHOW CREATE TABLE clientes;
SELECT @@GLOBAL.sql_mode;
SELECT @@SESSION.sql_mode;
SELECT COUNT(*) FROM origem WHERE email IS NULL;
A última consulta é um exemplo para contar, numa tabela de origem, as linhas que trazem NULL. O manual explica que, para procurar NULL, é preciso usar IS NULL: a comparação expr = NULL não devolve linhas, porque não é verdadeira para expressão alguma.
Pensando em um banco de dados na nuvem? 11SQL Mini a partir de R$ 9,90/mês; confira na loja o que cada plano inclui. Ver o 11SQL
Como corrigir o erro 1048
Estas são as opções que o manual descreve para cada comando. Teste cada comando numa cópia antes.
Faça backup antes de alterar a tabela
Antes de rodar um ALTER TABLE ou de mudar dados em massa, faça backup e teste o comando numa cópia da tabela.
1. Mande um valor para a coluna
Uma opção é fazer a aplicação ou a instrução enviar um valor válido no lugar do NULL.
2. Use a palavra DEFAULT no INSERT ou no UPDATE
O manual do INSERT diz que a palavra-chave DEFAULT define a coluna explicitamente com o valor padrão dela, e o manual do UPDATE diz o mesmo. Isso só serve se a coluna tem um padrão definido.
3. Dê um DEFAULT à coluna
A sintaxe do ALTER TABLE inclui SET DEFAULT e DROP DEFAULT. O padrão pode ser uma constante literal ou uma expressão, e as expressões entram entre parênteses, com uma exceção prevista no manual. Um exemplo, com um nome de coluna fictício:
ALTER TABLE clientes ALTER COLUMN status SET DEFAULT 'ativo';
O DEFAULT resolve o caso em que o comando deixa de citar a coluna. Se a aplicação continuar enviando NULL de forma explícita, ajuste também o comando, com um dos caminhos desta lista.
4. Permita NULL na coluna com MODIFY
Se o NULL faz sentido para o dado, a coluna pode aceitá-lo. A sintaxe do manual é MODIFY [COLUMN] col_name column_definition. Cuidado com o aviso do manual: a definição precisa incluir o tipo e os atributos que devem valer na nova coluna, exceto atributos de índice como PRIMARY KEY ou UNIQUE. Atributos que estavam na definição original e não foram repetidos não são mantidos. Se nem NULL nem NOT NULL forem informados, a coluna é tratada como se fosse NULL.
Rode o SHOW CREATE TABLE antes e copie os atributos que precisam continuar. Um exemplo:
ALTER TABLE clientes MODIFY email VARCHAR(100) NULL;
5. Troque o NULL por outro valor na consulta
Quando os dados vêm de outra tabela, as funções COALESCE e IFNULL trocam o NULL na própria consulta. O manual diz que o COALESCE devolve o primeiro valor que não é NULL da lista, e que o IFNULL(expr1, expr2) devolve expr1 se ela não for NULL e expr2 no caso contrário. Um exemplo, com endereço fictício:
INSERT INTO clientes (id, email)
SELECT id, COALESCE(email, 'sem-email@exemplo.invalid') FROM origem;
Desligar o modo estrito e usar IGNORE
É tentador desligar o modo estrito para o erro sumir, mas o manual diz que afrouxar a validação dessa forma não é recomendado. Além disso, fora do modo estrito, o INSERT de uma linha com NULL numa coluna NOT NULL continua falhando, segundo o manual do INSERT. O que muda é que as instruções de várias linhas passam a gravar o padrão implícito e a gerar avisos.
Sobre o sql_mode, o manual avisa que alterar a variável GLOBAL exige o privilégio SYSTEM_VARIABLES_ADMIN e vale para quem conectar depois. Alterar a da sessão afeta só o cliente atual.
A palavra IGNORE é outro caminho que o manual descreve. O ER_BAD_NULL_ERROR está na lista de erros que o IGNORE pode ignorar, e os erros ignorados geram avisos em vez de parar a instrução. O ER_NO_DEFAULT_FOR_FIELD não está nessa lista. Quando o IGNORE e o modo estrito estão juntos, o IGNORE tem precedência.
E no MariaDB?
O MariaDB usa o mesmo número 1048, o mesmo SQLSTATE 23000 e a mesma mensagem Column '%s' cannot be null, e o mesmo vale para o 1364, com o SQLSTATE HY000.
Erros parecidos que você pode encontrar
Se o valor enviado é maior que a coluna comporta, veja o guia do erro 1406 MySQL (Data too long for column). Se a mensagem for Data truncated, o guia do erro 1265 MySQL (Data truncated) ajuda.
Para quem vai escolher um servidor
A loja mostra os planos de VPS e o que cada um inclui.
Hora de olhar os planos de servidor? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Perguntas frequentes
O que significa o erro 1048 no MySQL?
Significa que a instrução tentou gravar NULL numa coluna declarada como NOT NULL. A mensagem é Column '%s' cannot be null e o SQLSTATE é 23000.
Qual a diferença entre o erro 1048 e o 1364?
O 1048 vem de um NULL enviado para uma coluna NOT NULL. O 1364 tem a mensagem Field '%s' doesn't have a default value e o SQLSTATE HY000, e se liga à coluna sem padrão que ficou sem valor.
Desligar o modo estrito resolve o erro 1048?
O manual diz que desligar o modo estrito para aceitar valores inválidos não é recomendado. Além disso, o INSERT de uma linha com NULL numa coluna NOT NULL continua falhando. As opções são enviar um valor, usar DEFAULT ou ajustar a definição da coluna.
O NULL em coluna AUTO_INCREMENT dá erro 1048?
Não. Segundo o manual, inserir NULL numa coluna inteira com AUTO_INCREMENT grava o próximo número da sequência.