SQLite中WITHOUT ROWID表插入时是否必须手动指定主键值？

你观察得完全没错——使用WITHOUT ROWID表时，确实必须手动指定主键值，这和普通SQLite表的行为差异很大，背后是WITHOUT ROWID表的核心设计逻辑，咱们一步步拆解：

1. 普通SQLite表的主键机制（对比参考） #

普通SQLite表默认会维护一个隐藏的ROWID列，它是一个自动递增的64位整数，作为表的物理存储主键。如果你定义了INTEGER PRIMARY KEY，这个主键其实是ROWID的别名，SQLite会自动帮你生成递增的主键值，不需要手动指定。比如普通表执行INSERT INTO A_TEST (X) VALUES('Test String')，ID会自动被赋值为1、2、3……

2. WITHOUT ROWID表的本质 #

WITHOUT ROWID表是SQLite中的聚簇索引表，它的核心特点是：

• 没有单独的ROWID存储层，数据直接存储在你定义的主键索引结构中
• 你显式定义的主键就是唯一的物理存储键，不再和隐藏ROWID关联

正因为没有了自动生成的ROWID，SQLite没有办法为你的主键自动生成值——毕竟它不知道你希望主键遵循什么规则（是递增、UUID还是其他逻辑），所以必须由你显式提供主键值，否则就会触发NOT NULL constraint failed错误（主键默认隐含NOT NULL约束，即使你没显式写出来）。

3. 你的案例解决方案 #

针对你创建的A_TEST表，有两种处理方式：

• 显式指定主键插入：执行插入语句时主动提供ID值，比如：

  INSERT INTO A_TEST (ID, X) VALUES(1, 'Test String');
  

• 放弃WITHOUT ROWID：如果需要自动递增的主键，去掉WITHOUT ROWID关键字，回到普通SQLite表的机制，这样ID会自动生成。

内容的提问来源于stack exchange，提问作者Carl Harrison