Mega 建圖失敗排查指南
在建圖的過程中，可能會出現上傳失敗、生成失敗等建圖失敗情形，多數問題源於採集數據質量不佳。在採集數據時應嚴格遵守數據採集文檔要求，可以避免如設備參數錯誤、路線規劃不當等引起的問題。若已經嚴格按照採集文檔進行採集，在建圖過程中仍然遇到了問題，請參考本文檔進行進一步排查。
什麼是正常的建圖流程
EasyAR Mega Block 的建圖流程主要分為數據上傳、軌跡生成、定位地圖和稠密地圖生成幾個步驟。
數據上傳
GoPro 採集的文件體積比較大（1 小時視頻，文件體積約為 30 GB），所以上傳過程根據網絡情況不同，上傳時長也可能比較長。上傳成功之後，可以在
Mega Block 建圖建圖任務的操作欄中查看上傳文件，需要核對文件名及數量是否與您本地文件一致，若數據一致則數據上傳無誤。上傳成功後，建圖狀態可能會顯示排隊中或生成中，也可以在線播放.LRV格式視頻。
附註
在數據上傳過程中還會對您上傳的數據進行檢驗，這個過程比較快，若中間沒有報任何錯誤，您可以忽略這個過程
軌跡生成
Mega Block 建圖系統需要恢復數據採集時的軌跡，這可能會花費一段時間。若建圖流程正常，您可以在軌跡生成或建圖完成之後，在
Block 建圖中查看建圖軌跡。為方便用戶確認採集的軌跡是否正常，EasyAR 提供軌跡預覽功能，對於所有建圖完成的 GoPro 數據，都提供
預覽空間軌跡功能，您可以按照空間軌跡，排查是否存在漏採數據的情況。
對於室外採集的數據，EasyAR 還提供
預覽 GPS 軌跡的功能
Mega Block 地圖生成
因 Mega Block 地圖生成計算量較多，這個階段耗時相對較長。建圖完成之後，建圖任務的狀態會顯示
任務完成。同時您還可以查看 EasyAR 提供的建圖報告。
GoPro建圖失敗現象及處理方案
數據上傳失敗
在上傳數據階段，因網絡或數據影響，可能會出現兩個問題：如果您的網絡較差，可能會出現上傳進度卡住、網絡中斷等問題；如果您採集的數據有問題，文件檢測將無法通過。
文件上傳失敗
典型表現：上傳進度卡住、回退或提示網絡中斷。
為什麼會發生：這通常是您的網絡環境不佳，您可以自行處理。
可以先嘗試刷新頁面或者重新登錄（避免登錄時間過長）
點擊 重新上傳：重新選擇數據文件夾，從頭開始上傳所有文件（適合上傳初期就失敗的情況）。
點擊 繼續上傳：選擇上次上傳失敗的數據文件夾（文件夾內文件不可改動），繼續從上次上傳失敗的文件開始上傳。
網絡優化：上傳期間需要保持瀏覽器窗口為活動狀態，上傳過程中請勿關閉瀏覽器、刷新頁面或點擊其他菜單，保持網絡通暢，避免進行其他大流量網絡活動。
附註
EasyAR 非常建議您在一個良好的有線或者無線網絡中上傳建圖數據，不建議您使用數據流量，因為 GoPro 視頻體積比較大。
文件檢測未通過
典型提示：XXX 視頻已損壞！、以下文件檢測到錯誤：XXX、XXX 文件名視頻幀率設置錯誤！
為什麼會發生：視頻文件上傳後，EasyAR 系統會對文件進行快速檢驗，將不合格的數據先行篩出，減少您等待的時間。可能是您未按要求進行採集，也可能是由於 SD 卡損壞、GoPro 設備問題引起的。
出現
XXX 視頻已損壞！或以下文件檢測到錯誤：XXX嘗試重新從 GoPro 內存卡里複製文件進行上傳
嘗試從其他電腦或者瀏覽器進行上傳
採集可能出現非正常關機等現象，您應當重新採集
出現
XXX 文件名視頻幀率設置錯誤！- 請根據GoPro 採集規範設置正確的幀率
附註
如果刷新頁面仍然無法通過檢測，那麼您應當重新按照 EasyAR 的採集規範，重新採集一遍數據。
建圖失敗
若您在 Block 建圖狀態中發現生成失敗，您可以查看建圖失敗報告。
- 出現
檢查輸入文件是否損壞（可能是視頻文件出現花屏導致），需要檢查視頻文件是否有花屏問題。 - 出現
檢查輸入文件是否損壞（可能是非正常關機，或拍攝時TF卡記錄卡頓導致）【視頻出錯時間：xx s】，需要檢查視頻在出錯時間附近是否有異常。 - 出現
內部錯誤，請反饋（可能是拍攝過程中，相機滑落，碰撞，發生快速位移，經過全黑環境，乘坐電梯導致），可能是在採集過程中，相機出現了滑落、碰撞等快速位移，採集人員乘坐電梯獲得異常的加速度，或者採集路線中存在全黑的場景。 - 出現
檢查輸入文件是否損壞，需要用視頻播放器播放採集的視頻，查看是否存在異常。 - 出現
服務器異常，稍後重試，請稍等一段時間後繼續嘗試建圖。
提示
若建圖報告中出現內部錯誤，請反饋或者建圖報告中未提示任何原因，請將建圖報告反饋給 EasyAR 工作人員。
附註
若建圖報告中給出了視頻出錯時間，且您的輸入為多段視頻的情況下，請自行換算對應視頻出錯時間點。
手機建圖失敗
手機建圖通常成功率較高。如果失敗，請優先檢查：
- 採集時是否一直停留在原地
- 環境光線是否充足
- 是否遮擋了攝像頭
如果確認採集無誤但依然失敗，請將建圖報告反饋給 EasyAR 工作人員。
問題反饋
如果您已完成上述自查，確認數據本身無明顯質量問題（無花屏、無參數錯誤），但建圖依然失敗，請按以下標準流程向 EasyAR 團隊反饋。
問題處理與反饋
發現真正問題後，請按以下方式收集信息並反饋，這樣技術團隊能快速定位和修復：
反饋信息
為了讓技術團隊快速定位問題，請務必提供以下信息：
建圖報告：在 Mega 開發中心下載格式的建圖報告，它包含了任務 ID、錯誤信息等。
採集規劃路線圖：提供採集規劃截圖或視頻，可以更快速定位問題。
將上述材料打包發送給對接的 EasyAR 技術支持人員。
反饋處理預期
技術人員會根據建圖報告，查看日誌和原始數據，並分析可能的原因：
- 採集嚴重違規（如嚴重抖動、全黑）：需要按規範重新採集
- 算法參數適配問題：我們將啟用高級建圖模式，調整雲端參數並嘗試為您重新生成 Block 地圖
如果常規參數調整無效，研發團隊會介入分析該數據是否屬於特定場景的算法盲區（如極端弱紋理），並評估是否能通過算法迭代修復。