SQLite / LiteDB 单文件数据库为何“清空表后仍占几 GB”?——原理解析与空间回收实战

关键词: SQLite、LiteDB、VACUUM、WAL、auto_vacuum、文件瘦身、数据库维护

在嵌入式或桌面、IoT 网关等场景,很多同学都会选择单文件数据库(SQLite、LiteDB、SQL CE...)。

最近群里一位朋友反馈:

"我的 test.db 已经把业务数据全删光,但文件依旧 3.8 GB!

甚至重启程序也没变小,这是为啥?"

别急,这并不是磁盘"被占用不释放",而是单文件数据库按页管理 、延迟回收的正常机制。本文将:

  • 揭秘删除数据后文件仍超大的五大原因
  • 手把手演示在 Linux / Windows 下 VACUUM / Rebuild 压缩操作
  • 给出线上环境自动瘦身 与写放大平衡的最佳实践

1 原理:删除 ≠ 收缩,空闲页仍在文件里

以 SQLite 为例:

  1. 固定页 (Page) 结构 -- 默认 4 KiB。
  2. DELETE / DROP TABLE 时,记录被打上 unused flag ,所在页被挂到 freelist。
  3. 文件尾部不会立即截断,因此操作系统看到的文件大小不变。
  4. 在 WAL 模式 下,.db-wal 日志同样采用追加写,旧数据也留在磁盘。
  5. 只有执行 VACUUM (或 auto_vacuum=FULL 时的新页写满)才会真正搬运存活数据 → 重写文件 → 释放未用 page。

LiteDB(.NET 生态)等其他单文件 DB 也采用相似策略,名字不同(如 Rebuild())而已。


2 五大常见原因对照表

# 文件仍巨大的原因 是否"异常" 解决手段
1 空闲页积累 :大量删除后未 VACUUM ⚠️ 正常 VACUUM;
2 WAL 日志残留 :.db-wal + .db-shm 未 checkpoint ⚠️ 正常 PRAGMA wal_checkpoint(TRUNCATE); 后 VACUUM;
3 预扩容 :曾设置 max_page_count、或工具一次写满 ✅ 设计如此 取消限制 → VACUUM;
4 隐藏/历史表:程序保留备份、软删除表 取决于需求 删除对象 → VACUUM;
5 非 SQLite:LiteDB、ESENT、LevelDB 等 ⚠️ 正常 对应的 Shrink/Compact API

3 手动压缩:三步到位

?? 注意 :VACUUM 会生成 同大小临时文件,磁盘需有足够空间并加排他锁,务必在维护时间执行!

bash 复制代码
# 进入 sqlite3 shell
sqlite3 test.db

-- 1) 看看是否在 WAL 模式
PRAGMA journal_mode;

-- 2) 手动触发 checkpoint(若是 WAL)
PRAGMA wal_checkpoint(TRUNCATE);

-- 3) 查看空闲页统计
PRAGMA freelist_count;

-- 4) 真正压缩
VACUUM;

.quit

若使用 LiteDB(C#):

csharp 复制代码
using (var db = new LiteDatabase("test.db"))
{
    db.Rebuild(); // 等价于 VACUUM
}

压缩后,你会发现文件大小立刻降到 "活跃数据 + 索引" 所需空间。


4 线上环境的最佳实践

  1. 启用 WAL

    sql 复制代码
    PRAGMA journal_mode=WAL;

    并定时

    sql 复制代码
    PRAGMA wal_checkpoint(TRUNCATE);
  2. 开启 incremental_vacuum + 定期触发

    sql 复制代码
    PRAGMA auto_vacuum=INCREMENTAL;
    PRAGMA incremental_vacuum;      -- 可以指定页数

    这样每晚只回收 N 页,避免一次性 I/O 峰值。

  3. 写扩散 vs. 瘦身平衡

    • 全量 VACUUM:文件最小、查询碎片最少,但重写成本高。
    • auto_vacuum=INCREMENTAL:每日轻量回收,I/O 峰值低。
      结合业务 QPS、磁盘 IOPS 选择折中方案。
  4. 监控 freelist_count + 文件大小

    通过 PRAGMA freelist_count; 与 Node 导出指标,当空闲页阈值 > 30 % 时触发压缩任务。


5 FAQ

问题 解答
VACUUM 会锁表吗? 会对整个 DB 加 排他锁,期间所有读写被阻塞。WAL 模式也不例外。
磁盘不足怎么压缩? 可先复制到大磁盘、《或》用 VACUUM INTO 'new.db'; 再替换。
WAL 文件多大合理? 官方建议 < 1 GiB;通过 PRAGMA wal_checkpoint(TRUNCATE) 清空到 ~0 字节。
能否自动释放? 设置 auto_vacuum=FULL,但写放大会增 I/O;线上更常用 INCREMENTAL。

结语

"删光数据文件却不变小" 99 % 都是因为你没有 VACUUM / Rebuild 。

了解单文件数据库的页式存储后,你就能自信地将文件瘦到最精简,也避免下次被 3 GB 大文件吓到。

相关推荐
数据库小学妹11 分钟前
数据库容量规划:四个数与扩容触发线
运维·数据库·后端
时间的拾荒人28 分钟前
Redis Cluster 集群详解:分片算法、搭建、故障处理与扩容实战
数据库·redis·算法·集群
纆兰3 小时前
MySQL的多表查询
数据库·mysql
七夜zippoe3 小时前
Nexent 模型配置:4 字段与 9 个槽位
数据库·人工智能·模型·nexent
进击的荆棘4 小时前
MySQL——表的操作
数据库·mysql
nice_lcj5205 小时前
MySQL 慢查询与 EXPLAIN:怎么定位、怎么优化
java·数据库·后端·mysql
OceanRoy16 小时前
数据库表的设计
数据库·内连接·外连接·er图·表的约束·三大范式·多表连接
Pniubi16 小时前
怎么排查慢SQL,怎么解决?
java·数据库·sql
薛之谦_17 小时前
Java 全栈知识体系:从 IDEA 高效开发到 JVM、并发与 Stream 实战
java·jvm·intellij-idea
Decay__20 小时前
VMware 安装 SQL Server 双节点 AlwaysOn 可用性组教程 —— WSFC、AG 与侦听器完整部署(系列核心篇)
运维·数据库·sql·mysql·架构