在SQLite里,DEFAULT子句远不只是给列塞一个静态数字或字符串那么简单。很多人在设计表结构时习惯性写上DEFAULT 0或者DEFAULT 'unknown',却没留意到当插入语句显式指定了NULL,或者使用了特殊的时间函数关键字时,默认值的触发逻辑会发生微妙变化。理解这些边界,是写出健壮建表语句的第一步。

DEFAULT的语法边界与NULL的处理顺序
SQLite中列定义的基本形态是列名 类型 DEFAULT 表达式。这里最容易被忽略的一点是:DEFAULT后面跟的其实是一个表达式,而不限于字面量。当一条INSERT语句没有为该列提供任何值,SQLite才会用这个表达式的结果填充。但如果INSERT里写了NULL,并且列没有NOT NULL约束,那么NULL会原样写入,默认值根本不会参与。
我们可以用一段简单的建表与插入来验证这种行为差异。下面代码中,score列有默认值,但第二次插入显式给了NULL:
CREATE TABLE user_log (
id INTEGER PRIMARY KEY,
score INTEGER DEFAULT 60,
note TEXT
);
INSERT INTO user_log (id, note) VALUES (1, 'miss score');
INSERT INTO user_log (id, score, note) VALUES (2, NULL, 'explicit null');
SELECT id, score, note FROM user_log;
执行后第一条记录的score是60,第二条则是NULL。这说明DEFAULT仅在“缺省”时生效,而不是“为空时兜底”。如果业务要求绝对不能有NULL,必须配合NOT NULL约束,此时显式写NULL会直接报错,从而强制走默认值或合法值。
另外,DEFAULT表达式在表创建时并不会被求值,而是每次插入缺列时才算一次。这意味着像DEFAULT (random())这样的写法,每一行拿到的随机值都不同,而不是全表共用一个建表时算出的死值。
动态默认值:内置关键字与表达式
除了常量和简单函数,SQLite提供了一组专门供DEFAULT使用的特殊关键字,最典型的是CURRENT_TIMESTAMP、CURRENT_DATE和CURRENT_TIME。它们会在插入那一刻取系统时钟,非常适合做创建时间、入库时间这类字段,免去了应用层拼时间的麻烦。
需要注意,这些关键字必须用括号包成表达式形式才合法,即写成DEFAULT (CURRENT_TIMESTAMP)而不是裸写。下面示例演示了一个带自动时间标记的日志表:
CREATE TABLE api_call (
call_id INTEGER PRIMARY KEY,
endpoint TEXT NOT NULL,
created_at TEXT DEFAULT (CURRENT_TIMESTAMP),
retry_count INTEGER DEFAULT (0)
);
INSERT INTO api_call (endpoint) VALUES ('/v1/login');
INSERT INTO api_call (endpoint, retry_count) VALUES ('/v1/pay', 3);
SELECT call_id, endpoint, created_at, retry_count FROM api_call;
上述写法里,created_at每次插入都自动填入当前UTC时间字符串,格式如2024-05-12 08:30:11。如果应用服务器和应用层都依赖这个字段排序,就不用担心客户端时钟不同步导致的乱序。
更进一步,DEFAULT里还能写带算术或字符串处理的表达式,比如DEFAULT ('user_' || abs(random()) % 10000)可以生成随机用户名前缀。只要表达式里调用的函数都是SQLite确定性或运行时安全的,就能稳定工作。不过要避开修改表结构后才变化的引用,否则会产生难以排查的数据不一致。
DEFAULT与CHECK、生成列的协作策略
单靠DEFAULT无法限制“非法但非NULL”的值,这时就要把它和CHECK约束放在一起看。比如某列默认是0,但业务上只允许0到100,如果只设DEFAULT不设CHECK,插入负数虽不触发默认也照样进库。正确做法是在表级或列级加CHECK。
以下例子展示默认值与CHECK如何互补,同时引入生成列(Generated Column)来派生一个始终小写的状态标记,避免应用层漏处理:
CREATE TABLE order_task (
task_id INTEGER PRIMARY KEY,
status TEXT DEFAULT ('pending') CHECK (status IN ('pending','running','done')),
raw_status TEXT,
low_status TEXT GENERATED ALWAYS AS (lower(coalesce(raw_status, status))) STORED
);
INSERT INTO order_task (raw_status) VALUES ('RUNNING');
INSERT INTO order_task (status) VALUES ('done');
SELECT task_id, status, raw_status, low_status FROM order_task;
这里status有默认值'pending'且被CHECK框定范围;low_status是生成列,永远根据raw_status或status转小写存储,写库时不需要程序管。如此一来,DEFAULT负责初值,CHECK负责守门,生成列负责冗余一致,三者分工明确。
还有一个实战陷阱:当表用了ALTER TABLE ADD COLUMN追加带DEFAULT的新列,SQLite会立即给老记录填默认值,这点和某些数据库延迟填充不同。若默认表达式是CURRENT_TIMESTAMP,所有老行会拿到同一个ALTER执行时刻,而不是各自原始创建时间,迁移历史数据时要额外用UPDATE修正。
总结来看,把DEFAULT当成“表达式触发器”而非“静态占位”,并把它放进NULL规则、CHECK边界和生成列体系里统一设计,才能发挥出SQLite轻量引擎下不轻量的建模能力。
SQLiteDEFAULT_clausecolumn_default修改时间:2026-08-17 19:40:34