> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/zh/backup-dr/snapshot-synchronization-errors-explained.md).

# 快照同步错误说明

VergeOS 平台提供一项称为 **站点同步** 的功能，用于复制系统快照的副本。

{% hint style="info" %}
**有关快照和站点同步的更多信息，请参阅我们的** [**关于同步配置的产品指南**](/automate-protect-and-extend/backup-and-dr/sync-configuration.md)**.**
{% endhint %}

有时，系统可能会因与站点同步功能相关的新消息日志条目而生成系统警报。以下是常见错误列表及简要说明：

### ybvsan：遍历第 3 层引用时出错：(2) 没有那个文件或目录

* 如果发送端和目标端之间的 VergeOS 软件版本不匹配，就可能发生此错误。

### 无法删除不再存在的快照：删除时未找到资源“/v4/cloud\_snapshots/1”

* 当快照正在删除且系统元数据中的引用被删除时，通常会由于时序问题而出现此错误。

### 与服务器通信时，使用“notify\_complete”通知客户端时出错 错误 (403)

* 快照已成功同步，但在同步清理过程中出现了此错误。如果此错误在多个快照同步中都出现，则两个系统之间的握手凭据可能已失效。此时，请联系 VergeOS 支持以获取帮助。

### 错误 - 未找到同步回传，且未提供注册代码

* 当请求将快照从目标站点回传到源站点时会出现此错误。如果出现此消息，说明两个系统之间未配置同步回传。请参阅 [同步回传指南](/automate-protect-and-extend/backup-and-dr/sync-back.md) 以获取在系统之间设置同步回传的说明。

### 错误 - “system name”的同步请求 错误通知客户端“notify\_start” 连接超时

* 当请求将快照从目标站点回传到源站点时会出现此错误，类似于前面的错误。请确保两个系统之间已正确配置同步回传。

### 在同步“snapshot name”时发生错误：资源暂时不可用。正在重试 1/10

* 此错误通常是由于源站点与目标站点之间的传输连接中断所致。同步将根据重试间隔设置自动重试。重试次数将不断增加，直到连接重新建立，或达到队列重试次数上限。

### 错误 - 无法创建租户快照“snapshotinterval\_yyyymmdd”：此名称已存在

* 本地快照计划将快照命名为与站点同步传入快照相同的名称。一个简单的解决方法是，通过编辑自动同步配置来重命名源端（发送端）快照。使用字段 **在目标端为快照名称添加前缀** 并添加一些唯一内容，例如 **remote-**.

### 无法更新系统快照：没有那个文件或目录

* 此错误表明快照可能存在时序问题。请检查 **传出同步** 发送站点上的配置是否有任何设置不匹配。

### 与客户端通信时，使用“notify\_start”通知客户端时出错 连接超时

* 由于连接超时，同步任务无法启动。通常，当请求将快照从目标端回传到原始发送端时会出现此错误。在大多数情况下，这是由于防火墙阻止了流量，或目标端缺少流量规则所致。请参阅 [关于同步配置的指南](/automate-protect-and-extend/backup-and-dr/sync-configuration.md) 以了解所需的流量规则。

***

***

{% hint style="info" %}
**文档信息**

* 最后更新：2024-08-29
* vergeOS 版本：4.12.6
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/zh/backup-dr/snapshot-synchronization-errors-explained.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.