mongod启动失败，日志里出现Fatal exception错误代码1020，往往是WiredTiger存储引擎检测到数据文件或元数据不一致，主动拒绝挂载这份数据。这个错误码本质上是存储层的一种保护机制，与其带着损坏的元数据继续运行导致脏数据扩散，不如直接退出。这篇文章围绕1020错误的产生原因、排查思路和几种修复手段展开，包括读取日志定位具体损坏的集合文件、使用mongod带repair参数执行离线修复、借助wt工具做salvage打捞恢复，以及修复失败时的备份兜底方案，同时强调修复操作的注意事项和日常预防措施。
故障码1020的成因分析
WiredTiger将集合和索引分别存储在独立的文件中，每个文件都有对应的元数据记录，主要保存在WiredTiger.wt和WiredTiger.turtle文件里。当元数据记录的checkpoint信息与实际数据文件内容对不上，或者BTree页面的校验和不匹配时，打开表的操作就会失败，mongod随即抛出1020错误并终止启动。理解这一点很重要，因为1020并不代表数据彻底丢了，很多时候只是部分文件损坏。
常见诱因有四类。一是服务器异常断电或mongod进程被强制杀死，checkpoint尚未完整落盘，journal也来不及回放；二是底层磁盘出现坏块，文件系统层面已经读写异常；三是多个mongod实例同时指向同一个dbPath，典型场景是拷贝数据目录后忘记改配置，或者虚拟机快照回滚导致新旧文件混用；四是运行期间手动移动或删除了dbPath下的部分文件。
排查的第一步是完整阅读日志。日志中通常会出现类似WiredTiger error (-31802)的字样，并指出具体无法打开的表，例如collection-8--2345678901234567890.wt。把这个文件名记下来，它对应MongoDB中某个具体的集合。接着用df -h和dmesg确认磁盘健康，如果内核日志里刷屏的是I/O error，必须先处理磁盘问题再谈修复，否则修好之后还会再次损坏。
使用mongod的repair模式执行修复
最直接的手段是官方提供的修复模式。先停掉所有mongod实例，确保没有其他进程占用dbPath，然后执行修复命令：
# 先完整备份整个数据目录，这一步绝对不能省 cp -r /data/db /data/db_backup # 以修复模式启动，注意此过程不提供正常服务 mongod --dbpath /data/db --repair # 修复完成后正常启动 mongod --dbpath /data/db --fork --logpath /var/log/mongod.log
repair的工作机制是重新回放WiredTiger.wt中记录的元数据，丢弃无法通过校验的数据页，然后重建集合和索引文件。这意味着修复是有损的：损坏页面对应的文档会永久丢失，但换回的是数据库能够正常启动。修复结束后建议用db.collection.count()和validate()逐个核对集合的完整性。
几点注意事项必须强调。第一，repair需要额外的磁盘空间，经验上预留原数据体积等量的空间比较稳妥；第二，repair期间数据库完全不可用，大库可能跑数小时甚至更久，务必安排维护窗口；第三，如果repair中途失败并再次报1020，说明元数据文件本身已经损坏，需要进入下一节的深度恢复流程；第四，副本集环境下不要在主节点上盲目repair，优先考虑用健康的从节点重新同步数据，代价小得多。
WiredTiger层级的手动抢救与兜底方案
当repair也救不回来时，可以尝试WiredTiger自带的salvage机制，利用wt命令行工具直接对损坏的集合文件做打捞式恢复：
# 导出损坏集合文件的数据 wt -v -h /tmp/rescue \ dump -f /tmp/rescue/collection-8--2345678901234567890.wt # 或者强制salvage重建该文件的BTree wt -v -h /tmp/rescue salvage file:collection-8--2345678901234567890.wt
如果wt工具不可用，还有一个偏手工的方案：先把损坏的.wt文件从dbPath中暂时移走，让mongod跳过该文件启动，数据库会报告该集合缺失，此时再从备份或从节点把数据灌回来。这个方案操作粒度细，但风险较高，每一步之前都要先做文件级备份，操作前务必再次确认mongod处于停止状态。
最后的兜底顺序建议是：副本集有健康从节点的，直接清空损坏节点的dbPath后重启，让副本集自动重新同步；有mongodump历史备份的，新建dbPath后用mongorestore恢复；两者都没有，就只能接受repair或salvage的有损结果。为避免再次遇到1020，日常应确保journal开启并放在独立可靠的磁盘上、杜绝多实例共用dbPath、配置副本集并定期执行mongodump备份。数据损坏永远是小概率事件，但只有事先有备份的人，才能把小概率事件变成小麻烦。
MongoDB 1020错误数据库文件损坏WiredTiger修复修改时间：2026-09-05 13:34:45