同步卡住

有時，當您的帳戶正在同步，儀錶板上顯示的同步狀態會定格在某個百分比（通常在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.

診斷一次卡住的同步

修復同步卡住的第一步，是確認它真的卡住了。有時同步可能需要很長時間，或者看起來卡住了，但其實只是它太慢了。跟隨以下步驟來確認問題：

1. 檢查儀錶盤中的同步狀態。它位於儀錶盤的頂欄中，通常顯示為「已同步」
2. 如果它顯示「同步中」，並且後面跟著一個百分比進度，看看進度是否正在變化或是增加。等幾分鐘後再看看以確保它不只是太慢了。
3. 如果它還是不動，那麼你的同步進度卡住了！

修復卡住的同步

修復一次正卡住的同步有點挑戰性，具體取決於問題所在，因此請務必按照我們的步驟操作。

First, let's try some steps which are common to many sync issues:

1. Try restarting Neos, this will re-start the sync process and can sometimes get it unstuck
2. Try disabling any mods, plugins or other modifications you have made to Neos, these may affect syncing.

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 上詢問更多信息。

Large Items

We've also seen reports of this occurring with exceptionally large assets. For example very high poly scenes and worlds, anatomically correct research models etc. In these cases these assets contain so much information that they can exceed the rate limiting just by themselves. If this is the case, then please try breaking them up as recommended above.

衝突

如果你找到了一條信息表明存在衝突，你需要前往 同步衝突 頁面。

其他的問題

如果以上情況都對應不上你的問題， 請在我們的問題跟蹤平台上或我們的 Discord 中向我們報告。無論你在這兩者中的哪個平台報告，都請務必提供 日誌文件.