同步出错怎么办

先查这几样

具体报错在「数据同步」页的「历史」里看（只保留最近 200 条）。先按顺序检查：

1. 网络是否正常
2. 网盘账号、密码、密钥或授权是否过期
3. 网盘空间是否足够
4. 同步目录是否还能访问
5. 是否改过网盘类型、文件夹、多网盘同步或「使用原始文件名存储」
6. 历史里的报错是什么意思，对照下面的 错误码表

解决后点重试，或重新同步。还是不行，依次试：

1. 换一个网络，或关掉代理、VPN 再试
2. 授权登录的网盘（百度网盘、123 云盘等）先取消授权（百度网盘叫「撤销授权」），再重新授权。浏览器授权失败时换一个浏览器
3. 把 Reeden 从后台彻底关掉，重新打开后停在「数据同步」页再点同步
4. 在书架上打开一本书的菜单，选「上传到云端」，看单独上传能不能成功

都不行时，在「关于」里点「分享日志」，把日志发给开发者。

常见错误提示和错误码

同步卡住、一直「等待中」，或者点了没反应

先把 Reeden 从后台彻底关掉，重新打开，停在「数据同步」页再点同步。

同步按钮是灰的、点了没反应：

• 先看「网盘」里的配置是否完整、「验证连接」能不能通过
• 开了「多网盘同步」时，「元数据」和「文件」两栏都要配置好，只配了一栏时不能同步。用不上多网盘就把它关掉

停在「正在对比本地和云端数据」：书和笔记多时，对比要等一会儿，先别反复点。

长时间还是卡着不动：在出问题的这台设备上用「云端覆盖本地」，让它直接以云端为准。覆盖前先看 普通同步和覆盖的区别。

提示「网盘文件未找到」

Reeden 准备从云端下载某个图书文件或资源文件，但在当前同步配置对应的网盘位置没找到它。常见原因：

• 云端同步目录里的文件被手动删除、移动或重命名
• 某台设备改过同步目录、网盘类型或多网盘同步
• 几台设备的「使用原始文件名存储」不一致
• 原来有文件的设备还没把图书文件上传完
• 当前设备同步到了书籍信息，但图书文件本身没在云端

按这个顺序处理：

1. 先不要清空云端目录，也不要反复切换同步配置
2. 检查网盘里的 Reeden 同步目录，看提示中的文件还在不在
3. 确认所有设备用的是同一套同步配置，包括网盘、同步目录、多网盘同步和「使用原始文件名存储」
4. 另一台设备还有这本书的本地文件时，在那台设备重新同步，把文件传上去
5. 回到报错设备点「重试」
6. 确定不需要这个文件时，可以点「跳过此项」，之后再手动导入或从完整设备重新同步

很多本书都报这个错，通常是几台设备的文件类同步配置不一致，或云端目录被改动过。先在数据和文件最完整的设备做备份，再决定是否重新上传。

个别书一直上传失败

其他书都正常，只有某几本反复失败，常见原因：

• 开了「使用原始文件名存储」，而书名里有网盘不接受的字符，比如 emoji 或特殊符号。不同网盘不接受的字符不一样
• 开了「使用原始文件名存储」，而且有同名的书，只有先上传的那本能传
• WebDAV 上文件路径太长，会提示「文件名过长，请修改书籍名称后重试」

处理方法：打开这本书的「编辑信息」，改最下面的「网盘文件名」（只在开着「使用原始文件名存储」时显示），去掉特殊字符或改短、改成不重名，再对这本书单独「上传到云端」。改的是云端文件名，书架上显示的书名不变。只能一本一本改。

如果这本书以前已经传上去过，改了「网盘文件名」后，要到网盘里把原来的文件也改成同样的名字，否则其他设备下载不到。

网盘要走代理才能访问

可以设置应用代理：

1. 进入「更多设置 > 网络」
2. 打开「应用代理」
3. 选择代理类型（HTTP 或 SOCKS5），填写代理地址和代理端口，需要认证时再填用户名和密码
4. 点「测试连接」确认能连通

应用代理用于同步和网盘书库，AI 等联网功能也会走这个代理。它只对当前设备生效，不参与同步，也不会被「从其他设备恢复」带过去。

云端数据对比

怀疑本地和云端的文件对不上时，在「数据同步」页右上角「⋯」里打开「云端数据对比」。它检查图书、字体、图片等文件类资源，会列出：

• 云端多余：云端有、本地已经不用的文件。确认不需要后可以删除，释放网盘空间
• 待上传：本地有、云端缺的文件。可以提交上传，其他设备之后才能下载
• 待下载：云端有、本机还没下载的文件。可以「一键全部下载」

适合这些情况：同步提示文件缺失或下载失败；书架有书但当前设备下载不到文件；云端目录被手动清理、移动或重命名过；换设备后部分图书、字体、背景图不完整；想清理网盘里不再用的文件。

它不逐条对比笔记、进度、标签这类元数据。看到大量「云端多余」或「待上传」时先别全部删除：确认所有设备的同步目录、多网盘同步和「使用原始文件名存储」一致后，再从数据和文件最完整的设备重新同步。

感觉数据丢失或变少

先不要反复点同步，也不要马上清空云端目录或卸载重装。先保住现有数据，再判断是哪一类问题：

1. 暂时停止其他设备继续同步或编辑
2. 找到数据最完整的那台设备，先在它上面导出一份 完整备份
3. 到「书库整理」里的「已删除书籍」看能不能还原
4. 到「数据同步 > 备份」看本地和云端的 元数据备份 里有没有丢失前的那份
5. 用「云端数据对比」看是不是只是图书文件、字体、图片没上传或没下载
6. 分清是书籍信息、笔记、进度变少了，还是只是图书文件没下载
7. 确认哪边数据最完整后，再决定恢复备份、重新同步还是覆盖

书架上有书、打开时提示下载，通常不是数据丢了，而是这台设备还没下载图书文件，见 同步常见问题。

不要先让数据不完整的设备继续同步，否则会把不完整的状态带到云端和其他设备。

同步方向弄反了怎么救

也就是「平板把手机的数据覆盖了」「用旧设备的数据盖掉了新数据」这类情况。先停止其他设备继续同步，再按情况处理：

• 在某台设备上错点了「云端覆盖本地」：覆盖前 Reeden 会在这台设备自动建一份本地元数据备份。到「数据同步 → 备份」，找覆盖前那份，点「恢复」，选「覆盖本地数据」。恢复后再「本地覆盖云端」，让云端也回到正确状态
• 在某台设备上错点了「本地覆盖云端」：它不会在本机建备份。找一台还没同步、数据还对的设备，在那台「本地覆盖云端」；其他设备也已经同步过了的话，到它们的「数据同步 → 备份」里找同步前自动建的那份恢复
• 普通同步后被旧数据覆盖：同样到「数据同步 → 备份」，找出问题前的那份恢复

历史备份只有元数据，不含书籍、字体、图片等文件。文件缺了，在还有文件的设备打开 云端数据对比 补传。

只丢了某本书的几条笔记时，也可以先把这本书现在的笔记导出成 JSON，恢复备份后再用「导入阅读数据」里的「通用阅读数据模板」导回去，避免恢复时把新笔记一起退回去，见 从其他 App 导入阅读数据。

以后怎么避免：

• 很久没用的设备，先「云端覆盖本地」再开始用
• 在一台设备改东西前，先同步一次
• 所有设备先升级到同一个版本再同步，旧版本不认识新功能的数据
• 各设备的同步内容开关保持一致

误删了书、主题或图片，其他设备也跟着删了

删除会同步到云端和其他设备，见 同步规则。按删的是什么处理：

• 书：删除时勾了「保留笔记与统计信息」的，到「书库整理」→「已删除书籍」还原，见 已删除书籍。没勾的，在执行删除的那台设备恢复删除前的 元数据备份，再在还有这本书文件的设备上传这本书
• 主题：恢复删除前的元数据备份，能找回主题本身和配色。背景图是文件，只能从还保留着这些图片的设备补传
• 我的图库里的图片、封面图集等：恢复元数据备份后，在还有图片的设备打开 云端数据对比，把「待上传」里的文件传上去

元数据备份只在「合并云端数据」时自动创建，只有一台设备同步时一直没有自动备份，见 为什么备份列表是空的。重要操作前，自己先建一份。