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 地图
如果常规参数调整无效，研发团队会介入分析该数据是否属于特定场景的算法盲区（如极端弱纹理），并评估是否能通过算法迭代修复。