书屿远端书下载失败：分开检查目录、文件与本地阅读

连接书库后能看见书名，却无法下载或打开，并不一定是同一个问题。目录、文件权限、网络传输和格式阅读分别可能出错。本篇用一份较小、已知正常的 EPUB 作为对照，按阶段排查书屿远端下载。先保留原连接与书籍记录，不通过删除整个书库来代替定位原因。

先记录失败发生在哪一步

把现象分为四类：连接失败、能列目录但找不到目标、能看到目标却下载失败、下载完成但无法阅读。写下当前服务类型、时间与提示，不必记录密码。服务器列表正常只证明部分请求成功，不能据此保证文件读取权限、下载地址和文件内容都正常。

再选一本已知可以在电脑打开的小 EPUB，放在同一受控书库位置。测试期间保持同一设备、网络和连接，先用这个样本走通，再处理原失败书。不要同时换账号、改目录和更新原文件，否则即使后来正常，也难以判断真正改善的是哪个环节。

在自己熟悉的环境中检查设备是否能访问服务器，家庭 NAS 可先在同一局域网测试。移动网络访问需要服务器本来具备可达条件，应用不会因为填入家庭地址就自动建立远程通道。地址、端口和协议以自己的部署为准，不猜测通用的固定值。

若外部客户端也连不上，优先检查服务器状态、网络与原有访问方式；若只有书屿异常，再比较两边使用的地址、账号和路径是否相同。证书或代理问题需要在部署侧核实，不要为了让一个请求成功就随意关闭重要验证，避免把暂时绕过误当成配置修复。

打开连接，逐层进入目标目录，核对书名与实际文件位置。服务器扫描结果可能仍保留旧位置，文件在外部移动后，目录卡片不一定立即反映变化。先在服务器端确认目标存在，再按当前提供的浏览或更新方式检查，不能仅凭旧封面判断文件仍在原处。

WebDAV 基础路径、SMB 共享名和实际目录不同，OPDS 目录还可能提供独立的获取链接。记录自己实际使用的入口，不把几种服务的路径写法互相套用。某个顶层目录可见，不代表子目录和目标文件都允许当前账号读取，需要进一步核对权限。

在服务器侧使用相同账号尝试读取这个样本，确认不是只能看目录而不能取文件。远端浏览会员状态与服务器账号权限也要分别确认：应用有权限使用远端功能，并不等于服务器允许它访问每个文件；账号有效也不代表当前应用权益已生效。

对于带代理或目录服务的连接，确认获取地址返回真正的书籍，而不是登录页、错误页面或不完整响应。不能因为文件名以 EPUB 结尾就认定内容一定是 EPUB。使用自己能管理的服务日志或外部客户端核对，分享排查信息时只保留必要错误，隐藏凭据。

确认设备有足够空间，再进行一次明确的下载并等待结果。不要连续点击造成多份相同任务，尤其大 PDF 和音频更应保持观察。下载结束后从实际可用的本地入口重新打开，不要只在刚才的远端阅读页翻两页，就认为完整副本已经准备好。

选择样本的开头、中间和结尾检查，再退出阅读页，断网重新进入。若能正常阅读，这条网络与下载路径基本可用，可再尝试原失败书。若断网后只剩封面，回到下载状态与文件来源继续核对；封面缓存和正文文件是两类内容，不能相互替代。

原失败书如果已经完整下载，却在阅读时出错，先在其他合适工具中检查同一文件。可能存在损坏、内容缺失或受访问保护，也可能属于只能管理而不能直接阅读的格式。书屿的格式声明应按具体范围理解，不要把导入成功当成所有格式都原生可读。

需要转换时保留原件，按文字、固定版面或图像用途取得合适副本，再重复内容检查。不要只改后缀或反复重建连接，这些操作不能修复正文结构。样本正常、特定文件异常时，重点记录该文件与失败位置，不必把整个服务器归类为不兼容。

写下最后确认正常的一步、第一处失败的一步，以及对照样本结果。例如“可列目录，小 EPUB 下载后可离线读，大 PDF 到中途失败”，就比“NAS 不好用”更有价值。下一次只改变一个条件，才能知道网络、文件大小或格式分别造成什么影响。

修复后按原来的失败动作重试，再做断网与末章检查。一次成功打开首页还不足以关闭问题，尤其原现象发生在下载末段时。保留原文件和重要笔记直到确认可靠，最终目标是得到可独立阅读的书，而不是让连接页只显示一个成功标记。