如何解决SQL INSERT时因违反非空约束NOT NULL导致的报错

必须显式赋值或完全不提该列以触发DEFAULT约束；仅设DEFAULT不设NOT NULL时NULL仍合法，设NOT NULL+DEFAULT后若INSERT显式赋NULL则报错，完全不提该列才生效。

报错“Cannot insert the value NULL into column 'xxx'”时，不是数据库“不讲道理”，而是你没按规则提供值——要么显式赋值，要么让 DEFAULT 约束真正生效。

INSERT 语句里漏了 NOT NULL 列名，但以为会自动填默认值

很多人写 INSERT INTO Users (id, name) VALUES (1, 'Alice')，却指望 email 列（定义为 NOT NULL DEFAULT '[email protected]'）自动填上默认值。实际不会生效：只要你在列名列表里没提它，SQL Server 才会触发 DEFAULT；但如果表结构里只加了 DEFAULT 没加 NOT NULL，哪怕省略该列，插入的仍是 NULL，照样报错。

• ✅ 正确做法：完全不写该列名，且该列必须同时满足 NOT NULL + DEFAULT
• ❌ 错误写法：INSERT INTO Users (id, name, email) VALUES (1, 'Alice', NULL) —— 显式写 NULL 直接炸
• ⚠️ 注意：DEFAULT 值必须是常量或确定性表达式，比如 GETDATE() 可以，GETDATE() + 1 不行

ALTER TABLE 新增 NOT NULL 列时没配 DEFAULT

给已有数据的表加新列并设为 NOT NULL，SQL Server 会直接拒绝，除非你同步指定 DEFAULT。

• ✅ 能成功：ALTER TABLE Users ADD phone VARCHAR(20) NOT NULL DEFAULT 'N/A'
• ❌ 会报错：ALTER TABLE Users ADD phone VARCHAR(20) NOT NULL —— 错误提示明确说 “only allows columns that can contain nulls, or have a DEFAULT definition”
• ? 加完后若要删默认约束，得先查约束名：SELECT name FROM sys.default_constraints WHERE parent_object_id = OBJECT_ID('Users')，再用 ALTER TABLE Users DROP CONSTRAINT [DF_Users_phone]

SQLAlchemy / ORM 插入时报 id NOT NULL 违反

模型里写了 id = Column(INTEGER, primary_key=True, autoincrement=True)，但建表 SQL 是手写的 id INTEGER NOT NULL，没用 SERIAL 或 GENERATED BY DEFAULT AS IDENTITY，就会导致 ORM 省略 id 字段插入，而数据库把它当 NULL 处理。

• ✅ PostgreSQL 正确建表：id SERIAL NOT NULL PRIMARY KEY（或 INTEGER GENERATED BY DEFAULT AS IDENTITY）
• ✅ 开发阶段推荐用 SQLAlchemy Base.metadata.create_all() 自动建表，避免模型和 DDL 脱节
• ⚠️ SQLite 下常见于 SqlSugar 实体类没配 [SugarColumn(IsNullable = true)]，或字段是值类型（如 int）却没设默认值

快速定位报错具体是哪一列

错误信息里已经说了，别跳过它：

• 看完整错误：Cannot insert the value NULL into column 'status', table 'Orders'; column does not allow nulls. → 直接锁定 status 列
• 立刻查表结构：SELECT COLUMN_NAME, IS_NULLABLE, COLUMN_DEFAULT FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = 'Orders' AND COLUMN_NAME = 'status'
• 确认业务逻辑：这个字段是否真不该为空？如果可以为空，就改约束；如果必须有值，就在 INSERT 里补上，或确保 DEFAULT 生效

最容易被忽略的是：DEFAULT 约束只在“完全不提该列”时才起作用，而不是“不给值”——后者在多数方言里等价于显式 NULL。别依赖直觉，查执行计划或用 SET STATISTICS XML ON 看 SQL Server 实际生成的 INSERT 语句长什么样。