// MySQL 错误参考

MySQL 错误 1048:列不能为空

INSERT 或 UPDATE 把 NULL 放进了声明为 NOT NULL 的列。请提供一个值、给该列设个默认值,或允许 NULL。

错误编号
1048
名称
ER_BAD_NULL_ERROR
SQLSTATE
23000
类别
键和约束
错误信息
Column '%s' cannot be null

它的意思

命名的列是 NOT NULL,并且语句明确将其设置为 NULL (或设置为求值结果为 NULL)。省略该列则会使用其默认值;如果没有默认值,在严格模式下会得到 1364。

常见原因

  • 应用程序代码向必填字段传入 null 用于必填字段。
  • 一个 INSERT ... SELECT 或者 UPDATE ... JOIN 在查找未找到行并产生 NULL.
  • 一个 CSV 导入,其中空字段映射为 NULL.

如何修复它

  1. 提供一个值,或用一个代入 NULL.

    INSERT INTO customers (name, country) VALUES ('Ada', COALESCE(@country, 'GB'));
  2. 给该列设置默认值,插入时将其省略。

    ALTER TABLE customers MODIFY country CHAR(2) NOT NULL DEFAULT 'GB';
  3. 如果该值确实可能是未知的,请允许 NULL.

    ALTER TABLE customers MODIFY country CHAR(2) NULL;

安全地复现它

CREATE TEMPORARY TABLE t (a INT NOT NULL);
INSERT INTO t VALUES (NULL);  -- ERROR 1048 (23000): Column 'a' cannot be null

相关错误

更多键和约束错误

代码和消息文本来自 MySQL 8.4 错误信息参考。浏览完整的 MySQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 MySQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 MySQL 以及你使用的其他数据库。