Base de Conhecimento

Erro 1048 MySQL: Column cannot be null, como resolver

  • erro 1048, mysql, column cannot be null, not null, modo estrito, sql_mode
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Erro 1048 MySQL: Column cannot be null, como resolver

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:

  • DESCRIBE mostra a estrutura da tabela, e a coluna Null vale YES se a coluna aceita NULL e NO se não aceita;
  • SHOW CREATE TABLE mostra o comando de criação da tabela e deixa ver quais colunas têm cláusula DEFAULT explícita;
  • as consultas abaixo mostram o sql_mode global e o da sessão;
  • SHOW WARNINGS mostra 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.

Esta resposta lhe foi útil?

Artigos Relacionados