Stuck Sync/zh

有时，当您的帐户正在同步，仪表板上显示的同步状态会定格在某个百分比（通常在10%）。这说明同步出现了问题，正在停止或暂停同步过程。

确保您正在阅读正确的指南

在我们有多个关于同步问题的解决指南，在继续阅读之前，请确保你正阅读的是为你的问题准备的，要查看同步问题总览，请前往 同步错误。

这些问题略有不同，可能需要不同的步骤，因此我们将它们分成单独的指南。

DO NOT

• Delete your Neos data/database or cache files. Doing this will likely make you lose your unsynced items, and can cause other side effects
• Try to save and sync any more items/worlds. Doing this will add to your sync queue and if your items/worlds are not syncing properly.
• Click "Exit & Save Homes". Doing this will also add to your sync queue.
• Send any objects or voice messages through the Contacts tab. Doing this will also add to your sync queue and will not send until any syncing issues are fixed.
• Change any settings. Doing this will also add to your sync queue and will not save properly until any syncing issues are fixed.
• Reinstall Neos. Doing this does not help syncing issues, as these are stored in a separate location.

Diagnosing a Stuck Sync

The first step for fixing a Stuck Sync, is to ensure it really is stuck. Sometimes syncing may take a long time or appear stuck but, it's just being slow. Follow these steps to confirm the issue:

1. Examine the sync status section of your Dash menu. It is in the top bar of the dash and will usually display "All Synced" in green
2. If it says "Syncing" and then a percentage, examine this percentage. See if it changes or increases. Give it a few minutes to double check that its not just being slow.
3. If it is still not moving, then you have a stuck sync!

修复卡住的同步

修复一次正卡住的同步有点挑战性，具体取决于问题所在，因此请务必按照我们的步骤操作。

1. 检查你的 日志文件
2. 那个离同步卡住时间最近的、其中包含了卡住的同步信息的文件，是你需要检查的。
3. 浏览日志文件并寻找问题所在，如果你不确定该怎么做，尝试在 Discord 问问，或者找其他能够帮助你定位到同步卡住信息的人。
4. 一旦你找到了关于同步卡住的信息，跟着下面你认为与日志中错误信息最相关的章节来排查问题。

过多请求

如果你找到了像是这样的信息:

Fail Reason: Response status code does not indicate success: TooManyRequests (429); Substatus: 3200; ActivityId: ....; Reason: (
code : TooManyRequests
message : The request rate is too large. Please retry after sometime. Learn more: http://aka.ms/cosmosdb-error-429, 

这个错误意味着，您与我们的数据存储系统之间存在速率限制，这是 Azure 云服务所限制的。

您可以按照以下步骤来尝试解决：

1. 尝试重新启动 Neos，这将重新开始同步过程并重试。
2. 尝试等待一段时间再重新启动或尝试再次同步。
3. 尝试等到 Neos 的流量低峰时段再进行同步。比如深夜和清晨

这可能需要最多 48 小时才能解决。

如果你没有什么耐心，还有一些方法你可以试试，这些方法将造成数据丢失:

• 强制让同步过程忽略那些导致卡住的数据。可以前往 [[Sync Conflict

| 同步冲突]] 指南，然后使用指南中的 -DeleteUnsyncedCloudRecords 选项来做到这件事。

• 你可以 清空你的数据库.

Avoiding this problem in the future

The Neos team are aware and are investigating this issue, see the bug report on our issue tracker for more information. In the mean time, try these recommendations to potentially reduce the amount of times you see it:

1. Avoid repeatedly saving the same object multiple times - For example, waiting a longer period of time between saving copies of worlds or avatars.
2. Avoid saving multiple items at once - For example, don't grab and save every single object you see.
3. Break up your saves, save an item...wait 5 minutes... save another item.
4. Try using your Local Home as a Local Backup.
5. Continue posting reports, log files and information on the bug report on our issue tracker
6. Ask in our discord for more information.

Conflicts

If you find a message stating that there is a conflict, you'll need to see Sync Conflict page instead.

Something else?

If you can't find something that matches the above list. Please report it on our issue tracker or in our Discord. In both cases make sure to provide a log file.