遇到“Cannot insert the value NULL into column 'xxx'”这个报错时，很多人第一反应是数据库在找茬。其实不然，数据库只是在严格执行规则——你没给它该有的值。要么你显式给个值，要么让DEFAULT约束真正起作用，否则就报错。先说说最常见的一个坑。
INSERT 语句里漏了 NOT NULL 列名，但以为会自动填默认值
很多人写INSERT INTO Users (id, name) VALUES (1, 'Alice')，心里想着email列（定义为NOT NULL DEFAULT 'unknown@example.com'）会自动填上默认值。实际不是这样的。只要你在列名列表里没提它，NOT NULL加上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 ha ve 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 语句长什么样。关键点来了：一定要同时设置 NOT NULL 和 DEFAULT，缺一不可。
