书屿 Calibre 目录搬迁检查：让 metadata.db 与书籍路径保持一致

Calibre 书库由元数据和实际文件共同组成，复制一个 metadata.db 并不等于已经复制整套书。本篇面向已经使用书屿连接 Calibre 的读者，解释电脑或 NAS 搬目录后怎样核对关系。先明确你使用的是 Content Server 还是数据库目录方式，再验证一本书，避免把两条连接路径混成同一个配置。

先确认当前连接方式

Content Server 通过运行中的服务提供目录与书籍，数据库方式则依赖 metadata.db 和对应的文件结构。先查看你原来在书屿中添加的类型，并记录服务器地址或书库目录。两者的入口和权限不同，不能因为都来自 Calibre，就把数据库文件路径填进服务地址字段。

如果原来方式一直正常，本次只处理搬迁引起的变化，不需要顺便更换连接方案。记录常读的一本书、作者、格式和章节短句作为样本。重要笔记先另存可读资料，原书也留副本，避免在排查路径时把唯一源文件移动后找不到原来的对应关系。

在 Calibre 自己的管理流程中确认书库

先用 Calibre 正常打开搬迁后的书库，检查书目、封面和实际阅读文件。优先使用它支持的书库管理方式，不在受管理目录里随意手工改作者文件夹或书籍编号。目录看起来整齐不代表数据库保存的路径已经同步改变，数据库与文件关系需要保持一致。

挑一份 EPUB 和一份 PDF，分别从管理端打开，确认不是只有元数据还在。若 Calibre 自己也找不到文件，先修复源库，不要在书屿里重复重建连接。源库正常是后续验证的前提，客户端无法凭一条书目自动补回缺失的正文和封面资源。

核对数据库与文件一起到位

使用数据库方式时，确认 metadata.db 来自同一套已搬迁书库，而不是上个月单独备份的旧文件。再核对它所对应的作者和书籍目录是否一并保留。只复制数据库能让书名出现，却可能无法读取正文，这属于资料与文件脱节，不是搜索词选择不当。

通过 WebDAV、SMB 或其他既有目录访问方式提供书库时，检查共享根目录能否看到整套结构。当前账号需要读取实际书籍所在子目录，顶层数据库可读不能证明正文也可读。路径中有空格或中文时沿用服务真实返回的结构，不靠猜测删去字符试图简化。

Content Server 搬迁则核对运行入口

使用内容服务器方式时，先确认新机器上的服务已经启动，书库选择正确，账号权限与原来一致。地址、端口、域名和代理路径应按实际部署填写，不把 Calibre 电脑所在的文件系统路径当作网络入口。电脑休眠或服务停止也会造成目录暂时不可达，应先排查源服务。

从外部客户端用相同账号浏览样本，再回书屿检查目录与获取。能登录不代表所有书库都开放给当前账号，能列书目也不代表获取文件的链接正确。若使用代理子路径，需要同时验证目录和下载，不应只凭服务首页可以访问就认定完整连接成功。

在书屿先读通一份样本

按当前提供的连接编辑或浏览方式进入新位置，找到已记录样本，核对作者与格式，再下载或打开。检查开头、中间与结尾，尤其不要只看封面。下载后断网重开，确认自己获得的是实际可读副本，而不是仅保留一份目录信息或临时加载的页面。

如果样本元数据正常但无法取文件，回到共享路径与读取权限继续查；如果文件已经取得却打不开，再与 Calibre 管理端打开的同一文件比较。把失败发生的阶段记录清楚，可以避免一遇到阅读异常就修改数据库路径，导致本来正常的部分也受到影响。

对照旧记录和多格式关系

搬迁后重新看到同名条目时，先比较版本、书籍身份和格式，不要马上合并或删除旧条目。已在本机的副本可能仍正常，来自新路径的副本则需要单独确认。阅读进度和笔记应以原文和章节核对，不只比较书名与百分比，尤其源库同时更新了版本时。

同一本有多个格式，先确定主要阅读哪一份，再检查备用格式是否实际存在。数据库里列出 EPUB 不代表该文件也已搬到新位置。若以后要清理旧目录，先核实每个重要格式的去向，并保留已导出的笔记，不能仅凭书架卡片数没有减少就删除原库。

让迁移清单成为以后依据

完成后记录连接类型、新入口或共享根目录、样本书名、已检查格式和迁移日期。密码继续按原有方式管理，不写进普通内容清单。若有某些大文件尚未复制完，明确列为待处理，不把少量样本成功扩大成全部书库都已完成逐本验收。

最后重开应用，再检查一本早期导入与一本新获取的书，确认常用路径清楚。源库、数据库、服务器入口和本机副本各有作用，了解它们的关系比反复扫描更能解决路径问题。以后更换 NAS 或电脑时按同样顺序检查，就不必从一张有封面却打不开的卡片重新猜原因。