故障排查
约 5 分钟
· 更新于 2026-07-04
同步不工作怎么办
登录同一个账号后,一台设备上复制的内容通常很快会出现在其它设备上。如果迟迟不同步,按下面的顺序排查,多数问题都能自己解决。
先排查最基础的两件事
大部分「不同步」其实是这两个最简单的原因:
- 网络连接:确认这台设备能正常上网。PasteLayer 需要联网才能上传和下载内容。
- 登录状态:确认两台设备都登录了同一个账号。没登录、或登录的是不同账号,内容自然不会互通。
好消息是,PasteLayer 对网络波动有很强的容错:离线时它不会放弃,而是自动按指数退避的节奏重试(大致是 30 秒、2 分钟、5 分钟逐步拉长间隔);一旦检测到网络恢复、服务器重新可达,它会立即中断等待、马上续传,不用你手动干预。所以短暂断网后稍等片刻,同步通常会自己跟上。
看懂常见的同步错误
如果排查完网络和登录还是不行,往往是遇到了某种具体的同步限制。下面用大白话解释几种最常见的情况:
- 存储配额已满:你的云端存储空间用完了。清理一些不再需要的内容,或升级套餐来扩容后,就能继续同步。
- 图片过大:单张图片超过了云端备份的大小上限(50MB)。超限的图片文字条目仍会同步,但原图无法上云备份。
- 客户端版本过旧:服务端更新后,旧版客户端可能需要升级才能继续使用完整功能。看到「需要更新」类的提示时,请把 PasteLayer 更新到最新版。这种情况不会让你退出登录,只是提醒你升级。
- 网络类错误:比如安全连接失败、连接超时、暂时连不上服务器等。这些都会自动重试,通常无需处理。
- 登录失效:如果登录态过期,客户端会尝试自动刷新;确实失效时会提示重新登录。
大多数错误 PasteLayer 都会自动重试,你会在界面上看到「稍后会自动重试」之类的提示,稍等即可。只有配额已满、图片过大这类需要你处理的情况才需要动手。
卡片上的「同步失败」徽章是什么意思
当某张卡片(主要是图片卡片)的原图没能成功同步时,卡片右下角会出现一个红色的感叹号云朵徽章。把鼠标移上去,会弹出「同步失败」的说明,告诉你具体原因,例如:
- 原图同步失败,将自动重试 / 原图上传失败(网络或服务端异常),将自动重试:这是临时性问题,客户端会自动再试,一般不用管。
- 读取本地原图失败,将自动重试:本地读取原图时出错,也会自动重试。
- 本地原图数据缺失,无法同步备份:本地找不到这张图的原始数据,无法备份。
- 图片超过 50MB 上限,无法云端备份:图片太大,属于永久性限制,不会再重试。
- 云端存储空间已满,清理图片或升级套餐后可继续备份:配额满了,清理或升级后即可恢复。
一句话总结:带「将自动重试」的徽章你可以放心等待;提示「无法备份」的则说明命中了大小或配额限制,需要你相应地缩小图片或释放/扩容空间。
想了解同步的工作原理
如果你想更深入地理解「为什么某条内容会(或不会)出现在另一台设备上」,可以阅读《跨设备同步是怎么工作的》,里面讲清楚了增量同步、冲突解决,以及图片为什么走独立通道、有时会比文字稍晚到达。