同步卡住

有时，当您的帐户正在同步，仪表板上显示的同步状态会定格在某个百分比（通常在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 小时才能解决。

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

• 强制让同步过程忽略那些导致卡住的数据。可以前往 同步冲突 指南，然后使用指南中的 -DeleteUnsyncedCloudRecords 选项来做到这件事。
• 你可以 清空你的数据库.

避免在今后遇到此问题

Neos 团队已经知晓并正在调查该问题，可查看 在问题跟踪平台上的Bug报告以获得更多信息。而在此之前，可通过以下建议来尽可能的减少出现该问题的次数：

1. 避免多次重复保存同一物品 - 如，保存世界副本和保存化身之间间隔的时间可以长一点。
2. 避免一次保存多个物品 - 如，不要到处保存你所见过的所有物品.
3. 分批保存，保存一个物品...等五分钟...保存另一个。
4. 尝试使用你的 本地家 作为本地备份.
5. 在问题跟踪平台上的Bug报告中继续提交报告，日志文件和相关信息
6. 在我们的 Discord 上询问更多信息。

冲突

如果你找到了一条信息表明存在冲突，你需要前往 同步冲突 页面。

其他的问题

如果以上情况都对应不上你的问题， 请在我们的问题跟踪平台上或我们的 Discord 中向我们报告。无论你在这两者中的哪个平台报告，都请务必提供 日志文件.