page type must be index page = LiteDB 数据库文件损坏,它去读取一个索引页的时候,读出来的页标记不是 IndexPage(读到了 DataPage / CollectionPage / EmptyPage)。
LiteDB 内部页类型:IndexPage(跳表索引)、DataPage(存文档)、CollectionPage、ExtendPage、EmptyPage。
最常见触发原因(工控 / WPF 上位高频)
- 程序崩溃、断电、直接杀进程,数据库没正常 Close / Checkpoint(MES、上位机日志库头号元凶)
- 多进程同时打开同一个
.db文件(LiteDB v5 默认单写,多进程并发写极易坏库!) - 磁盘异常:U 盘、SD 卡、嵌入式 eMMC 掉电、磁盘缓存未刷盘
- 版本混用:v4 的 db 文件直接用 v5 打开(页结构完全不一样)
- 手动拷贝 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 上位 / 采集服务重点)
- 禁止多进程同时打开同一个 db 文件 LiteDB v5 不是多进程数据库!多进程读写同文件是定时炸弹。 ✅ 正确:只在一个服务进程里打开;别的进程走 WebAPI/TCP 网关读写(正好你 Go 网关架构)
- 程序退出、关闭窗口时,一定要 dispose LiteDatabase
// using 或者手动 .Dispose(),触发 checkpoint
db.Dispose();
- 嵌入式 / 盒子上:不要直接断电;有条件开启写缓存刷盘;日志库尽量不要放 SD 卡
- 做定时备份(简单方案):空闲时复制 db 到备份目录,或者用 LiteDB 导出 json 备份
- 大流量采集日志:不要全部塞一个 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# 代码 + 坑点,贴合你工控采集场景:
- 高频查询字段建索引
- 大批量写入用事务
- 索引不要泛滥,索引增加写入开销、文件体积
- 定期压缩、维护库(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();
👉 运维策略(工控上位推荐)
- 在夜间 / 产线停机、空闲时段执行,不要在高峰期跑
- 顺序建议:先备份 → 再 Rebuild/Shrink
- 频率:日志量大的库,7~15 天一次;基础配置库 30 天一次足够
- 注意:Rebuild 期间阻塞读写,业务暂停;Shrink 相对轻一点
配套给你一套 LiteDB 最佳实践总结(适配 MES 采集)
✅ 高频查询字段建索引,优先唯一索引、复合索引 ✅ 批量 Insert/Update 必须包事务,提升速度 + 保证原子性 ✅ 索引宁缺毋滥,写入密集的日志表更要克制 ✅ 定时备份 + 低峰期维护(Rebuild/Shrink) ✅ 单进程打开 db,禁止多进程同时读写同一个 db 文件(头号坏库元凶) ✅ 大日志建议按天分库 log_20261023.db,隔离损坏风险
补充容易踩的坑
EnsureIndex放在循环里是错的,放程序启动一次即可- 事务里面不要做耗时很长的外部 IO(串口、相机),事务持有锁,卡死查询
- Shrink/Rebuild 不是自动的,LiteDB 不会自己缩小文件!删数据之后文件体积不会自动变小,这是很多人疑惑的点
- Rebuild 不能修复严重页损坏(就是你刚才那个报错严重的时候,Rebuild 直接抛异常)
如果你想要,我给你封装一个带【启动建索引、批量事务写入、定时备份 + 定时 Shrink】的 LiteDBHelper。