昨天下午四点半，实验室那台 2011 年的 Mac Pro 开机时风扇声像要起飞，屏幕上跳出一行灰字：「17 图库索引卷未挂载」。我盯着那台机器愣了十几秒，因为里面存着 2019 年跑敦煌壁画图像比对项目时留下的 1.8 万张缩略图。
这件事的起点其实很平常。我的合作者周明远——就是那个总穿灰夹克、说话前先推眼镜的档案数字化工程师——上周把一份整理好的图库目录结构发给我，说原来的样本库在迁移过程中断过一次电，索引文件可能写坏了。他当时在电话里补了一句：「你先别急着重做，先看看卷挂载日志。」这句话后来帮了大忙。
先定位，再动手
我打开终端，先用 diskutil list 确认物理卷还在，只是文件系统标记成了未验证状态。接着翻到系统日志里 2026 年 9 月 26 日 23:47 那条记录，提示的确实是索引表的尾部校验和不匹配。这说明问题不在图片本体，而在描述图片位置的那张「地图」上。对于「图库恢复正常17图库」这类任务，判断损坏发生在哪一层，比直接重建索引要节省至少六个小时。
周明远建议我参考他以前处理类似情况的笔记，其中提到一个容易被忽略的细节：17 图库的缩略图命名里带有一组 6 位十六进制短码，恢复索引时可以先用短码做一轮去重比对，再去核对文件哈希。我按这个思路写了个小脚本，跑完发现 1.8 万条记录里有 214 条短码重复——都是当年批量导出时留下的副本，并不是真的丢失。
三个具体动作，让恢复过程可复现
第一个动作是备份索引区。我把损坏的索引文件复制到外置 SSD 上，命名为 index_20260926_broken.db，大小是 48.7 MB。第二个动作是用数据库自带的完整性检查命令扫了一遍，输出里果然看到三处页校验失败，位置都在文件尾部。第三个动作最笨但最稳：把原始图片按目录分批重新计算哈希，每批 2000 张，和索引里残留的记录交叉核对。
中间还有个小插曲。我一开始想走捷径，直接让程序重建全部索引，结果跑到 68% 的时候卡住，因为有两个子目录的路径名里含有全角空格，解析器把后半截当成了独立字段。这个坑后来是靠手动修改路径映射表绕过去的。如果你也在处理类似情况，可以先看看 浏览器怎么切换网页版 里关于路径与界面识别的说明，虽然不是同一件事，但思路相通。
恢复图库索引最怕的不是数据量大，而是你分不清「文件没了」和「记录丢了」。这两件事的处理顺序完全相反。
我的观点：别迷信一键恢复
说实话，我不太赞成把「图库恢复正常」完全交给一键修复工具，尤其是当样本量超过一万张的时候。一键工具往往跳过哈希校验，只按文件名重建目录，看起来恢复成功，实际上把重复文件和真正缺失的文件混在了一起。这次 214 条重复记录就是证据。更稳妥的方式是先人工确认索引结构和校验字段，再让工具做批量劳动。顺便提一句，如果遇到已经被误删的索引相关页面，可以参考 一键恢复已删网站 里的记录，思路是通用的。
到了凌晨两点零七分，脚本输出最后一行：restored 17,862 / 17,862 records。我打开图库客户端，缩略图一张张重新出现，敦煌第 57 窟那张飞天局部也在其中。那一刻我确实兴奋，但更让我踏实的是整条路径都被日志记了下来。后来我把这套流程也同步到了团队的文档里，并补上了 49图库官方app下载方式 作为移动端对照参考，免得下次有人又从头摸索。
