快照同步错误说明

解释常见 VergeOS 站点同步错误消息、其原因以及快照同步问题的推荐解决方案的参考指南。

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

有关快照和站点同步的更多信息，请参阅我们的 同步配置产品指南.

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

ybvsan：遍历第 3 层引用时出错：(2) 没有这样的文件或目录

• 如果发送端和目标端的 VergeOS 软件版本不匹配，就可能出现此错误。

无法删除已不存在的快照：删除时未找到资源“/v4/cloud_snapshots/1”

• 此错误通常是由于快照删除时出现时序问题，并且系统元数据中的引用已被删除所致。

在与服务器通信时，使用“notify_complete”通知客户端出错：错误 (403)

• 快照已成功同步，但此错误出现在同步清理过程中。如果在多个快照同步中都出现此错误，则两个系统之间的握手凭据可能已停止工作。在这种情况下，请联系 VergeOS 支持寻求帮助。

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

• 当从目标站点请求将快照返回到源站点时，会出现此错误。如果出现此消息，说明两个系统之间未配置同步回传。请参阅 同步回传指南 以获取在系统之间设置同步回传的说明。

错误 - 针对“system name”的同步请求：使用“notify_start”通知客户端出错：连接超时

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

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

• 此错误通常是由于源站点和目标站点之间的传输连接中断所致。同步会根据重试间隔设置自动重试。重试次数会递增，直到连接重新建立或达到队列最大重试次数。

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

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

无法更新系统快照：没有这样的文件或目录

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

使用“notify_start”通知客户端出错：连接超时

• 同步任务无法启动，因为连接已超时。通常，此错误出现在从目标端向原始发送端请求返回快照时。大多数情况下，这是由于防火墙阻止了流量，或者目标端缺少流量规则所致。请参阅 同步配置指南 以了解所需的流量规则。

在与服务器通信时，使用“notify_start”/“notify_complete”通知客户端出错：错误 (500)

• 批量数据传输仍会完成——快照在两端都显示为正常，数据也会继续流动——但每个同步周期中的开始和结束通知调用都会返回 HTTP 500。这通常表明源系统和目标系统之间存在重大版本不匹配（例如，旧版本系统与 26.x 系统同步）。底层数据路径比通知 API 更能容忍版本差异，因此快照会在两端落地，而通知会报错。要解决此问题，请将落后的一端升级到与另一端兼容的版本。对于较大的版本差距，您可能需要先经过中间版本分支，而不是直接跳到目标版本。版本对齐后，下一次同步周期中错误就会停止。