LiteDB 数据库文件损坏:page type must be index page

page type must be index page = LiteDB 数据库文件损坏,它去读取一个索引页的时候,读出来的页标记不是 IndexPage(读到了 DataPage / CollectionPage / EmptyPage)。

LiteDB 内部页类型:IndexPage(跳表索引)、DataPage(存文档)、CollectionPage、ExtendPage、EmptyPage。

最常见触发原因(工控 / WPF 上位高频)

  1. 程序崩溃、断电、直接杀进程,数据库没正常 Close / Checkpoint(MES、上位机日志库头号元凶)
  2. 多进程同时打开同一个 .db 文件(LiteDB v5 默认单写,多进程并发写极易坏库!)
  3. 磁盘异常:U 盘、SD 卡、嵌入式 eMMC 掉电、磁盘缓存未刷盘
  4. 版本混用:v4 的 db 文件直接用 v5 打开(页结构完全不一样)
  5. 手动拷贝 db 的时候程序还在写,拷贝到半截

先区分:能不能救

LiteDB 没有强大的修复引擎,分两条路:

方案 1:还有备份(优先,工控系统必须做定时备份)

直接用备份 db 覆盖,损失最小。

你的场景:MES / 采集日志,强烈建议:定时备份 db,或者冷热分离,大日志切分。

方案 2:无备份,尝试 Rebuild(LiteDB 官方唯一修复手段)

// 方式A:代码重建
using(var db = new LiteDatabase("yourfile.db"))
{
    db.Rebuild(); // 重建,会丢弃损坏的索引页,尽量恢复文档
}

或者用 LiteDB Studio 打开,执行 SQL:

REBUILD;

⚠️ Rebuild 会:

  • 尽量捞能读的文档数据
  • 损坏的索引直接丢掉,索引要重新 EnsureIndex
  • 如果文档页本身也坏了,这部分数据直接丢失

很多时候 rebuild 之后这个报错消失,但索引全部没了,查询变慢,你要重新建索引:

col.EnsureIndex(x=>x.SN, true);
col.EnsureIndex(x=>x.CreateTime);

方案 3:Rebuild 仍然报这个错(页头严重损坏)

👉 这个 db 基本救不回来,损坏的索引链已经断了,只能丢弃这个库,从备份恢复。

非常重要:怎么避免再次出现(你 C# WPF 上位 / 采集服务重点)

  1. 禁止多进程同时打开同一个 db 文件 LiteDB v5 不是多进程数据库!多进程读写同文件是定时炸弹。 ✅ 正确:只在一个服务进程里打开;别的进程走 WebAPI/TCP 网关读写(正好你 Go 网关架构)
  2. 程序退出、关闭窗口时,一定要 dispose LiteDatabase
// using 或者手动 .Dispose(),触发 checkpoint
db.Dispose();
  1. 嵌入式 / 盒子上:不要直接断电;有条件开启写缓存刷盘;日志库尽量不要放 SD 卡
  2. 做定时备份(简单方案):空闲时复制 db 到备份目录,或者用 LiteDB 导出 json 备份
  3. 大流量采集日志:不要全部塞一个 LiteDB,按天分库(log_20261023.db),坏一个只丢一天数据

踩坑补充

  • 不要用文件复制方式做热备份(程序正在写的时候复制 = 坏库)
  • LiteDB Studio 打开损坏库,有时候也直接抛这个异常,这时只能代码里尝试 Rebuild
  • 如果你是 LiteDB v4 升级 v5:不能直接打开老 db,要先导出 json 再导入新版本

应急判断口诀

这个报错 = 索引页损坏 有备份 → 回备份 无备份 → Rebuild 捞数据,重建索引 Rebuild 失败 → 文件报废

💥💥💥💥💥💥💥💥💥💥💥💥

为经常查询的字段创建索引
使用事务处理大量数据
避免过多的索引,每个索引都会增加存储开销
定期对数据库进行压缩和维护

https://oa22.cn/bbs.asp?id=28933

LiteDB 这 4 条实操落地(适配你的 WPF 上位、MES、设备日志场景)

先复述要点,再给 C# 代码 + 坑点,贴合你工控采集场景:

  1. 高频查询字段建索引
  2. 大批量写入用事务
  3. 索引不要泛滥,索引增加写入开销、文件体积
  4. 定期压缩、维护库(Rebuild / Shrink)

LiteDB 底层是单文件、B + 树跳表索引,和 SQL Server 思路相近,但细节不一样

1. 为经常查询的字段创建索引

适合:SN、条码、设备编号、时间、工单编号,这类你经常Where过滤的字段

var col = db.GetCollection<LogRecord>("log");
// 普通索引
col.EnsureIndex(x => x.DeviceId);
// 唯一索引(SN、条码,不会重复)
col.EnsureIndex(x => x.SN, true);
// 复合索引:经常同时按设备+时间查
col.EnsureIndex(x => new {x.DeviceId, x.CreateTime});

✅ 什么时候建:程序启动一次性 EnsureIndex(幂等,重复调用不会重复创建) ❌ 不要:给备注、内容、长文本、极少查询的字段建索引

2. 批量数据用事务(LiteDB v5)

不使用事务:每一次 Insert 就是一次单独 Checkpoint,大批量写入极慢,还容易掉电损坏 LiteDB 事务是 BeginTransaction / Commit / Rollback

var col = db.GetCollection<LogRecord>("log");
using(var trans = db.BeginTransaction())
{
    for(int i=0;i<1000;i++)
    {
        col.Insert(new LogRecord(){SN=$"SN{i}",CreateTime=DateTime.Now});
    }
    trans.Commit(); // 一次性落地磁盘
}
  • Commit 成功:全部写入;中途异常:Rollback,全部回滚,不会半截坏数据
  • 适合:批量导入、批量采集上报、历史数据迁移

注意:LiteDB 事务不能跨多个 LiteDatabase 实例,仅限同一个 db 实例

3. 避免过多索引

代价:

  • 插入、更新、删除时,每一个索引都要同步更新,写入变慢
  • 索引占用额外磁盘空间
  • Rebuild 重建索引耗时变长

经验规则(MES 日志表参考):

  • 一张集合,索引控制在 1~4 个最佳
  • 只给【查询过滤、排序】的字段建索引;只展示、不筛选的字段不加
  • 如果字段很少用来查询,宁可全表扫描,不要加索引

举例子:日志表 ✅ 需要索引:SN、DeviceId、CreateTime ❌ 不要索引:Content、OperatorName、Remark

4. 定期压缩维护(LiteDB 重点!和 SQL 不一样)

LiteDB 有两个概念:

  • Rebuild:重建所有页、重建索引、清理碎片(同时修复轻度损坏,就是你刚才 page type must be index page 用的)
  • Shrink:把空闲空间回收,缩小 db 文件物理大小
// Rebuild(重建,会重新生成全部索引,慢,适合低峰)
db.Rebuild();

// Shrink 压缩(只回收空闲空间,不重建索引,速度快)
db.Shrink();

👉 运维策略(工控上位推荐)

  1. 在夜间 / 产线停机、空闲时段执行,不要在高峰期跑
  2. 顺序建议:先备份 → 再 Rebuild/Shrink
  3. 频率:日志量大的库,7~15 天一次;基础配置库 30 天一次足够
  4. 注意:Rebuild 期间阻塞读写,业务暂停;Shrink 相对轻一点

配套给你一套 LiteDB 最佳实践总结(适配 MES 采集)

✅ 高频查询字段建索引,优先唯一索引、复合索引 ✅ 批量 Insert/Update 必须包事务,提升速度 + 保证原子性 ✅ 索引宁缺毋滥,写入密集的日志表更要克制 ✅ 定时备份 + 低峰期维护(Rebuild/Shrink) ✅ 单进程打开 db,禁止多进程同时读写同一个 db 文件(头号坏库元凶) ✅ 大日志建议按天分库 log_20261023.db,隔离损坏风险

补充容易踩的坑

  1. EnsureIndex 放在循环里是错的,放程序启动一次即可
  2. 事务里面不要做耗时很长的外部 IO(串口、相机),事务持有锁,卡死查询
  3. Shrink/Rebuild 不是自动的,LiteDB 不会自己缩小文件!删数据之后文件体积不会自动变小,这是很多人疑惑的点
  4. Rebuild 不能修复严重页损坏(就是你刚才那个报错严重的时候,Rebuild 直接抛异常)

如果你想要,我给你封装一个带【启动建索引、批量事务写入、定时备份 + 定时 Shrink】的 LiteDBHelper。

正文完
 0