Logo章鱼速贴文档

    同步失败

    复制了内容,另一台设备却收不到,按本页排查。先分清是哪一层出问题:内容没记进来源端历史(捕获)、记下了但传不过去(传输)、传到了但粘不出来(粘贴)。从来源端开始,沿这三层往下查,能减少重复试错。

    不确定该看哪页?先用 排障概览 的最小测试定位是哪一层。

    赶时间?

    最快排查:确认剪贴已在来源设备的历史中、两端使用同一种同步方式,再用一段唯一短文本重试。任一不满足就从那里入手。

    适合谁看

    • 已能在单台设备看到剪贴历史,但跨设备收不到内容的用户
    • 不确定该先查同步方式、网络,还是来源端权限的用户

    如果两台设备互相发现不了,先看 设备发现失败;本页默认设备已能配对或已登录同一账户。

    不要混用同步路径

    一端用附近同步、另一端用云同步时,常表现为"完全收不到"或极不稳定。请先让两端使用同一种同步方式,再开始下面的排查。

    先做一次最小测试

    在来源设备复制这段纯文本,用它贯穿后面三层检查:

    最小测试文本text
    octoclip-sync-failed-001

    第一层:来源端是否记下了

    跨端收不到时,先在来源设备的剪贴历史里找这次复制。历史里没有,就不是同步的问题,先修捕获。

    1
    确认应用在运行且未暂停

    来源端能打开应用并进入剪贴历史页面,监听未被手动暂停。

    2
    在来源端历史里查找测试文本

    复制 octoclip-sync-failed-001 后,在来源端历史列表确认它出现了。

    3
    若历史里没有这条记录

    说明内容没被记下来,停在这一层。移动端尤其常见:未开启或未走通剪贴板后台监听时,往往要先打开应用再复制才会写入历史。机制与开启方式见 剪贴板后台监听

    来源端历史里没有就别先改同步方式

    历史里查不到这次复制时,另一端自然"等不到"。这时改同步方式、重连云端都没用,应先解决"没记下来"。

    第二层:内容是否传得过去

    来源端历史里有这条记录、目标端却没有,问题在传输层。按你使用的同步方式展开对应检查。

    1

    确保两台设备均已在设置中开启「附近同步」开关。

    2
    3
    4

    若设备仍无法在列表中被搜索到,请精准转到 设备发现失败

    第三层:传到了但粘不出来

    目标端历史里已经能看到这条剪贴,却用不出来时,问题在粘贴/使用层。

    在纯文本输入框测试

    先在普通文本编辑框(如系统的记事本、备忘录)里尝试手动粘贴,排除目标应用(如特定的企业软件、表单)本身的粘贴限制。

    2
    确认目标应用已聚焦且允许粘贴

    某些机密应用或系统策略会拦截非用户手动触发的程序化粘贴行为。

    3
    检查自动粘贴所需权限

    若启用了“点击自动粘贴”或快捷辅助功能,macOS 平台必须确保已开启「辅助功能」与「输入监控」权限;参见 macOS 权限说明

    4
    排除快捷键冲突

    确认触发自动粘贴的快捷键没有和其它应用冲突。

    修复后如何验证

    • 在来源设备复制 octoclip-sync-failed-001
    • 目标设备的剪贴历史中出现该文本。
    • 目标设备能成功粘贴出相同文本。
    • 反向测试也成功(目标端复制、来源端收到)。

    仍未解决

    请反馈以下信息:

    • 两台设备平台与系统版本
    • 应用版本
    • 使用的同步方式(附近同步 / 云同步)
    • 卡在哪一层(来源端历史没有 / 历史有但目标端收不到 / 目标端能看到但粘不出来)
    • 失败方向(A → B / B → A / 双向)
    • 内容类型(纯文字 / 链接 / 图片 / 文件引用)
    • 网络环境(同一 Wi-Fi / 不同网络 / VPN / 代理 / 防火墙 / 公司网络)
    • 复现步骤(最短路径)
    • 错误提示截图或日志片段

    下一步

    这篇文档有帮助吗?