失败提示往往指向症状,不指向病因,先分类再动手
先说结论。倾斜摄影切片跑到一半停下,绝大多数不是"软件坏了",而是四类问题之一:输入数据本身有缺陷、机器资源被耗尽或抢占、输出路径写不进去、外部进程把任务打断。真正省时间的做法不是反复重跑,而是先按这四类定位,判断这一次该修数据、该调资源,还是该换个时间再来。本文给出一套可执行的分类与排查顺序,并说明哪些情况应当立即停止重试。

失败的任务如果成因没有变化,重跑的结果通常也一样。中途失败通常意味着某个条件在处理到特定阶段时才被触发:某个子目录读到一半才发现贴图缺失,内存累积到某个阈值才被系统终止,磁盘写到某个文件才耗尽空间。这些条件不会因为重来一次就消失。
所以第一步不是点重试,而是分清这次中断发生在哪个阶段。刚开始就退出,多半是输入或配置问题;跑到中段才退出,多半是资源或权限问题;跑到接近尾声退出,往往是空间或单文件过大。阶段本身就是线索。
这类失败的特点是稳定复现,同一份数据每次都在类似位置停下。
1)目录结构不完整:OSGB 的 Data 目录下有缺层或缺块,读取到缺口时任务中断。
2)贴图缺失或损坏:几何文件存在,但对应贴图打不开,纹理阶段报错。
3)坐标信息缺失或异常:原点为空、坐标系未定义,或平移值明显超出合理范围。
4)文件名或路径含特殊字符:过长、含空格或全角符号,读取阶段偶发失败。
5)单文件体积过大:个别瓦片文件异常大,读取时内存峰值被抬高。
这类问题的处理方向是回到数据环节修复,修好再切,反复重跑只会浪费时间。
这类失败与机器状态相关,同一份数据在不同时段结果可能不同。
1)内存不足:处理后段内存占用上升,被系统回收,进程被终止。
2)磁盘空间不足:输出目录所在分区写满,写入失败后任务结束。
3)CPU 或磁盘被其他任务占满:并发过高或同时运行多个重负载程序,任务被拖到超时。
4)临时目录受限:系统临时空间不足,中间产物无法落盘。
这类情况的判断方法是看资源占用曲线:如果内存在失败前持续爬升,问题多半在内存;如果磁盘在失败前接近写满,问题在空间。对应的动作是降低并发、腾出空间、错峰运行,而不是改数据。

这类失败容易被忽略,因为提示信息常被理解为"文件不存在",实际是"写不进去"。
1)输出目录无写权限:目录属主或权限设置限制写入。
2)路径含中文、空格或过深层级:部分环节对路径字符敏感。
3)目标盘为只读或网络盘:网络存储抖动、断连会导致写入中断。
4)杀毒或同步软件占用文件:安全软件实时扫描与文件锁冲突。
判断方法很直接:换一个本机、全英文、层级很浅的目录做小规模试切。如果试切通过,问题基本锁定在权限或路径。建议把工作目录统一放在本地磁盘的短英文路径下。
这类失败与任务本身无关,属于环境事件。
1)进程被手动结束或系统休眠:长时间任务遇到系统睡眠会被挂起。
2)电源或散热导致的降频、断电:笔记本或散热不足的机器长时间满负载时容易出问题。
3)网络存储或授权的会话过期:依赖授权的模块在长时间运行中会话失效。
这类问题的特征是"没有规律",处理方向是改善运行环境:关闭休眠、接稳电源、避免在任务期间做重负载操作。

把上面的内容收拢成一份排查顺序,从上到下走,命中即停。
1)先看失败阶段:刚开始失败看输入(第 2 节),中段失败看资源(第 3 节),接近完成失败看空间与单文件(第 2、3 节)。
2)再做小样试切:用一小块全英文短路径的数据复现一次,区分"数据问题"与"环境问题"。
3)接着看资源曲线:内存与磁盘在失败前的走向决定是调并发还是腾空间。
4)然后核对权限与路径:确认输出目录可写、路径无敏感字符。
5)最后排除外部事件:确认期间没有休眠、断电、他人抢占或会话过期。
哪些情况应立即停止重试、先修数据:输入类中凡是涉及缺块、贴图损坏、坐标缺失的,重复重跑不会改善;资源类若在调整并发和空间后仍稳定复现,也要回头检查数据是否异常大。只有在确认为外部中断时,才适合直接重跑。这份顺序的价值在于把随机尝试变成有方向的排除,每一次调整都能缩小范围,而不是把所有可能一次性改掉。
想先对照每一步在界面上的落点,可以参考 倾斜模型切片图文教程,里面从导入到导出的环节都有演示。
万一自己定位不了,把下面这些信息一并提供给支持方,比单说"跑失败了"有效得多。
1)失败发生的大致阶段与完整提示文字。
2)数据规模:目录层级、大致文件数量、最大单文件体积。
3)失败前那一刻的资源占用情况:内存与磁盘。
4)输出路径的写法,以及所在磁盘的类型。
5)所用版本号与运行环境(系统版本、是否虚拟机)。
6)是否可稳定复现,以及最小复现所用的数据范围。
中途失败最有价值的地方,是它用一次停止告诉你哪里不稳。养成先分类、再动手的习惯,比记住一堆零散技巧更管用。下一次它再停下时,先问一句:这次是数据的问题,还是环境的问题。
需要提醒的是,失败原因有时是叠加的,比如数据缺口与内存不足同时存在,本文无法穷举所有组合。若按清单仍无法定位,或数据本身涉密、敏感,请勿把原始数据上传到公共渠道,联系支持方时只提供必要信息即可。站内既有讨论可作参考,在文档社区检索切片失败讨论 能省下重复提问的时间。
顺带说明一点:3D Tiles 这类输出规范的细节由 OGC 3D Tiles 标准页 定义,理解规范能在排查输出结构问题时提供参照,但它不解释运行环境层面的中断。
关键看成因是否稳定。外部中断(休眠、他人抢占、会话过期)具有随机性,重跑可能就通过了。而输入数据缺口、贴图损坏、坐标缺失属于确定性缺陷,处理到同一位置必然再失败,重跑多少次结果都一样。判断方法是对同一份、同一范围的数据连跑两次:两次都在同一阶段失败,基本可判定为数据或配置问题;两次失败位置不同,才更像资源或环境问题。
不一定。先分清是内存峰值还是磁盘空间。内存问题可以通过降低并发、分段处理缓解;磁盘问题则是腾空间或换分区。只有在调低并发、腾出空间后仍在相同位置失败,才需要考虑换更高配置的机器。判断前先记录失败前的内存与磁盘曲线,避免盲目加硬件。
不可以。涉密、敏感或未公开的测绘成果不得进入公网,也不应上传到任何公共渠道。正确做法是自行完成本文的分类排查,只把不含敏感信息的提示文字、规模描述、资源曲线和版本环境提供给支持方;确需对方协助时,应按所在单位的成果管理规定走内部流程,用脱敏样例复现。
一般不能直接当作成果使用,但可以保留用于判断。中途失败的输出目录往往包含不完整的瓦片与缺失的顶层文件,直接发布会出现加载不全或结构错误。稳妥做法是保留该目录用于比对失败位置,确认成因后清理,再重新导出完整结果。不要在不完整输出上叠加新任务。
要把基础流程先跑通、用好手边的工具,可以从 下载 GISBox 试用基础版切片流程 获取安装包,用一小块数据走一遍完整链路,再回到大范围任务。
【内容与技术说明】
本文由GISBox产品团队整理发布,内容由AI工具辅助生成并经团队人工核验。
因产品版本持续迭代,具体功能、参数与免费范围以GISBox官方文档为准。
如有技术疑问或内容勘误,欢迎通过support@gisbox.com反馈。
最后核校:2026-10-14。