高枝个人博客 土木读研 · 计算机 × 土木的交叉笔记
返回列表

小项目该不该用 SQLite:我把表结构重写了三遍之后的结论

个人博客、日历、书签工具,到底什么时候 SQLite 就够了?什么时候必须上 Postgres?这篇给出一套可判断的决策标准。

先说结论:单机、读多写少、数据量在百万行以内,SQLite 是最优解,而且没有之一。

我的三次重写

这个博客的第一版,我用了 PostgreSQL。数据都在一台机器上,容器里跑着一个 400MB 的 Postgres。为了 12 篇文章,我启动了 12 篇文章的复杂度。

第二版换成 SQLite,但表结构照搬 Postgres 的设计——到处是 BIGSERIAL、TIMESTAMPTZ、一堆用不上的索引。看起来专业,实际上全是负债。

第三版才想明白:数据库应该服务于你现在的问题,不是你想象中的规模。

一套可判断的标准

看四个问题,答案都是 yes 就可以安心用 SQLite:

1. 是不是单机?

SQLite 没有网络层。如果你的应用跑在一台机器上,那「数据库进程」和「应用进程」是两个进程已经足够,多一个网络往返纯属浪费。

2. 写入并发够用吗?

SQLite 的写入是串行的。这是它最大的限制,也是很多「SQLite 也很强」文章刻意不提的点。

javascript
// SQLite 的写入是全库级串行锁,WAL 模式下读者不阻塞
// 但写者之间严格排队
const result = db.prepare('INSERT INTO posts (title) VALUES (?)').run('标题');
// 高频写入场景下,这里会成为瓶颈

我的经验值:单表每秒几百次写入以内,SQLite 毫无压力。超过这个量级,或者需要分库分表,就该换。

3. 需要什么高级特性?

特性 SQLite PostgreSQL
全文检索 ✅ FTS5 ✅ tsvector
JSON 索引 ✅ ✅ GIN
地理空间 ✅ RTree ✅ PostGIS
物化视图 ❌ ✅
逻辑复制 ❌ ✅

前三项 SQLite 都有。我这个博客用了 FTS5 做全文检索,完全够用。

但有一个坑值得单独说:FTS5 默认的 unicode61 分词器不切分中文。它会把连续的中文当成一个 token,所以搜「事件循环」能命中,搜「性能」却搜不到(因为「性能」不是任何 token 的前缀)。解决办法是自己加一层 LIKE 兜底。

4. 需要高可用吗?

如果答案是不需要,那 Postgres 的 WAL 复制、故障转移对你来说都是运维负担,而不是收益。

表结构上我犯的错

迁移到 SQLite 后我保留了一堆 Postgres 习惯,这是错的:

sql
-- ❌ 从 Postgres 抄来的
CREATE TABLE posts (
  id          BIGSERIAL PRIMARY KEY,
  created_at  TIMESTAMPTZ NOT NULL DEFAULT NOW()
);

-- ✅ 为 SQLite 重新设计
CREATE TABLE posts (
  id          INTEGER PRIMARY KEY AUTOINCREMENT,      -- 显式 AUTOINCREMENT 避免 id 复用
  created_at  TEXT    NOT NULL DEFAULT (datetime('now'))  -- ISO 字符串,天然可读
);

差别不只是语法。datetime('now') 生成的是 2026-10-05 16:30:00,直接查库就能看懂;TIMESTAMPTZ 在终端里显示的是一串偏移量。

迁移成本有多高?

这个博客的表结构现在完全兼容两者:

  • AUTOINCREMENT → SERIAL,改一行
  • datetime('now') → NOW(),改一处默认值
  • INTEGER PRIMARY KEY 保持不变

唯一需要重写的是 FTS5,得换成 tsvector。

所以我的建议是:先用 SQLite 写,把表设计干净,等真的要迁移的那天,成本是半天而不是两周。