同步与排查

漫阅+ 服务器连接排查:把网络、登录、目录和页面分开检查

用一个已知样本定位 WebDAV、SMB、Komga、Kavita 或 OPDS 的失败阶段,整理可复查的错误信息。

“服务器连不上”可能指很多不同现象:地址打不开、账号被拒绝、列表为空、封面出现但正文失败,或阅读正常而下载失败。把它们合成一个问题,很容易在已经正常的环节反复修改。本篇给出一条按层次缩小范围的路径,适用于你自己管理或获授权访问的私人书库。

先记住最后一个正常环节

记录服务类型、App 版本、当前网络、发生时间和完整错误文字。用普通描述说明最后成功的动作,例如“能进入共享但看不到漫画目录”或“能列出系列、打开正文时报错”。截图时隐藏地址中的私人部分、用户名、口令、令牌和具体个人书库内容。

准备一份小样本与一个正常对照。如果问题出现在某一本书,找同一服务中另一份普通小文件;如果所有内容都失败,先验证服务网页或管理者提供的访问方式。不要同时更换密码、修改路径、换协议和删除连接,否则即使恢复,也不知道真正原因是什么。

第一层:确认地址和网络可达

检查设备是否在预期网络上,局域网地址是否只能在家中使用,NAS 是否正常运行。WebDAV、Komga、Kavita 和 OPDS 地址还要核对协议、端口及子路径;SMB 则要分清主机、共享和目录。浏览器管理页面地址不一定是文件协议地址,某本书的详情链接也不是服务器基础地址。

如果使用了自己管理的远程访问或代理方案,先确认它在当前设备上可用。不要为排查临时公开原本私有的共享,也不要靠关闭全部证书验证解决长期配置问题。网络层未通过时,反复改变书架名称或清空本地缓存通常不能修复服务不可达。

第二层:检查登录与账号权限

使用当前账号核对服务器允许的操作。密码更新、账号尚未完成设置、共享书库未授权,都可能导致不同结果。浏览器中保留的旧会话可以继续显示页面,并不能证明你刚输入的密码有效;需要明确验证当前账号状态。

认证错误通常要回到地址、服务类型和凭据检查;权限拒绝则应查看账号允许的范围。HTTP 401 或 403 等状态可以提供线索,但代理或服务器实现也可能影响返回,不能只凭数字断定唯一原因。让管理者结合对应时间的记录确认,比反复提交同一错误凭据更有效。

第三层:目录为空和页面失败分开处理

能够登录但没有预期书籍时,核对共享范围、选择的目录、服务器是否已识别文件,以及当前过滤条件。SMB 共享、WebDAV 文件夹和漫画服务器的系列列表不是同一种层级,不能用完全相同的目录路径套用所有入口。

目录和封面正常而页面失败时,选择同一服务中的另一份小样测试。若只有一个文件出问题,检查格式、完整性和服务端处理结果;若所有页面都失败,查看页面读取权限和访问路径。OPDS 还要检查是否提供兼容页面流,普通整包条目缺少逐页能力不应被归为账号密码错误。

第四层:只在下载时失败

在线阅读正常而下载失败,应检查当前来源是否提供下载,以及账号是否被授予下载权限。接着查看设备存储、任务状态和失败发生阶段。下载过程中失败与传输后导入失败可能需要不同处理,不要把所有错误都简化为网络速度慢。

对已经成功的任务保留结果,只重试失败项。如果多个任务同时失败,可以减少并发,用单个样本建立基线。重复添加相同任务或清空全部下载记录会丢失定位线索。重要的是得到一个可重复的成功或失败样本,而不是让页面上出现更多重试中的项目。

实例:封面正常但正文不能读取

假设 Komga 中一个系列的封面正常显示,打开任意章节都失败。先用相同账号在服务端确认该账号拥有逐页读取权限,再检查一个已知正常的小章节。若另一个账号可读,不应直接换成管理员账号作为长期解决,而应让管理者核对原账号的权限范围。

再比如 OPDS 能展示书名却提示缺少页面流,应直接转向协议能力检查,不必重复修改密码。把两种情形分别描述清楚,能让开发者或服务器管理员知道问题在权限还是内容能力,而不是收到一条难以重现的“App 不能用”。

整理一份有帮助的反馈

反馈写明复现顺序、预期结果、实际结果、发生时间、服务类型与版本,以及对照样本表现。保留错误文字即可,日志可能包含地址和账号信息,应先检查并脱敏,避免在公共评论中直接粘贴整份记录。没有必要提供自己的完整漫画文件或账户口令来证明问题存在。

删除连接重新添加,是不是最快?

有时需要重新配置,但先记录现有地址结构、账号和最后成功环节。删除连接会失去现场线索,也可能产生与原记录不同的新连接。先修正明确的问题,再用小样验证,通常比盲目重建更可控。

我换了网络就好了,可以认定 App 没问题吗?

只能说明网络条件影响了这一次结果,不能据此证明所有环节都没有问题。保留两个网络下的差异,以及相同样本的表现;把已观察到的事实和推测分开,后续才能进一步定位原因。

接下来读什么

资料来源与版本

资料核对:2026 年 10 月 22 日,漫阅+ 2.0.2,iPhone / iPad。依据中国区 App Store 公开说明、Apple 版本查询与对应功能入口整理。界面名称可能随版本调整,功能权限以 App 当前购买页面为准。