# 同步失败

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

不确定该看哪页？先用 [排障概览](/advanced/troubleshooting/overview) 的最小测试定位是哪一层。

> [!TIP] 赶时间？
> 最快排查：确认剪贴已在**来源设备**的历史中、**两端使用同一种同步方式**，再用一段唯一短文本重试。任一不满足就从那里入手。

## 适合谁看

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

如果两台设备**互相发现不了**，先看 [设备发现失败](/advanced/troubleshooting/device-discovery-failed)；本页默认设备已能配对或已登录同一账户。

> [!WARNING] 不要混用同步路径
> 一端用附近同步、另一端用云同步时，常表现为"完全收不到"或极不稳定。请先让两端使用**同一种**同步方式，再开始下面的排查。

## 先做一次最小测试

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

```text title="最小测试文本" noLineNumbers
octoclip-sync-failed-001
```

## 第一层：来源端是否记下了

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

:::steps
:::step{title="确认应用在运行且未暂停"}

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

:::
:::step{title="在来源端历史里查找测试文本"}

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

:::
:::step{title="若历史里没有这条记录"}

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

> [!NOTE] 来源端历史里没有就别先改同步方式
> 历史里查不到这次复制时，另一端自然"等不到"。这时改同步方式、重连云端都没用，应先解决"没记下来"。

## 第二层：内容是否传得过去

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

:::tabs
:::tab{label="附近同步"}

:::steps{collapsible}
:::step{title="确认两端启用附近同步"}
确保两台设备均已在设置中开启「附近同步」开关。
:::
:::step{title="确认配对状态"}
在附近设备列表中，确认两端能够互相发现且已处于已配对/已连接状态。
:::
:::step{title="网络权限与环境"}
确认应用已获得系统的「本地网络访问」权限。确认两端连接的是同一个 Wi-Fi 局域网。
:::
:::step{title="排除防火墙与网络隔离"}
检查系统防火墙、路由器访客隔离网络（Guest Network）、VPN 或代理是否拦截了局域网点对点通信。
:::
:::

若设备仍无法在列表中被搜索到，请精准转到 [设备发现失败](/advanced/troubleshooting/device-discovery-failed)。

:::
:::tab{label="云同步"}

:::steps{collapsible}
:::step{title="确认账户与配置一致"}
确认两端登录的是相同的章鱼速贴账户，或使用了完全一致的私有同步密钥配置。
:::
:::step{title="确认启用云同步"}
确保两端在设置中均将同步路径设置为「云同步」并开启。
:::
:::step{title="检查网络出口"}
确认当前局域网没有使用企业强力防火墙拦截 outbound 的云端连接，或尝试更换为手机热点网络测试。
:::
:::

:::
:::

## 第三层：传到了但粘不出来

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

:::steps{progress=1}
:::step{title="在纯文本输入框测试"}
先在普通文本编辑框（如系统的记事本、备忘录）里尝试手动粘贴，排除目标应用（如特定的企业软件、表单）本身的粘贴限制。
:::
:::step{title="确认目标应用已聚焦且允许粘贴"}
某些机密应用或系统策略会拦截非用户手动触发的程序化粘贴行为。
:::
:::step{title="检查自动粘贴所需权限"}
若启用了“点击自动粘贴”或快捷辅助功能，**macOS** 平台必须确保已开启「辅助功能」与「输入监控」权限；参见 [macOS 权限说明](/advanced/macos/permissions)。
:::
:::step{title="排除快捷键冲突"}
确认触发自动粘贴的快捷键没有和其它应用冲突。
:::
:::

## 修复后如何验证

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

## 仍未解决

请反馈以下信息：

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

## 下一步

:::cards{cols=2}
:::card{title="首次使用排障" icon="lucide.triangle-alert" href="/getting-started/first-run-troubleshooting"}
首次跨端就收不到内容时，按更完整的首跑排障顺序检查。

:::
:::card{title="同步方式概览" icon="lucide.git-compare" href="/features/sync-overview"}
不确定该用附近同步还是云同步时，对照场景重新选择。

:::
:::card{title="设备发现失败" icon="lucide.scan-search" href="/advanced/troubleshooting/device-discovery-failed"}
两台设备互相发现不了时，从发现层单独排查。

:::
:::card{title="剪贴板后台监听" icon="lucide.monitor-cog" href="/features/source/background-monitoring/"}
来源端"没记下来"时，理解后台监听与各端限制。
:::
:::