模型打不开、加载慢或旋转卡顿，应该按什么顺序排查？
先区分文件问题、访问权限、网络传输和终端渲染，再处理具体原因。用同一个 .zbim 分别做本机打开与云端打开对照，可以缩小问题范围；文件小并不必然意味着旋转和剖切流畅。
适用条件
- 能够取得出现问题的模型版本、转换记录、报错时间和终端信息。
- 可以使用一个已知可正常打开的小模型作为对照，并有权限读取目标文件。
操作步骤
- 记录失败阶段。区分选文件前、下载中、解析时、出现画面后和某项操作时出错，截图保留完整报错。
- 核对文件完整性。确认文件来自成功转换的结果，传输没有中断；比较交付方提供的大小和校验信息。
- 做本地与云端对照。本地也打不开时先检查格式和转换结果；仅云端失败时再核对登录、项目权限、文件版本及网络。
- 检查浏览器与图形环境。记录浏览器版本、显卡、驱动和图形加速状态，用另一个受支持终端复测，勿通过关闭访问控制解决问题。
- 缩小模型范围。先打开单栋或单专业，再逐步增加；记录哪些构件、材质或操作触发卡顿。
- 提交可复现问题。提供最小授权样本、操作顺序、配置和日志，避免只有一句“很慢”却无法定位。
检查与交付依据
| 现象 | 先核对 |
|---|---|
| 仅云端打开失败 | 下载是否完成、授权与文件版本 |
| 出现画面后卡顿 | 可见几何量、终端资源、材质与操作 |
| 浏览器画布消失 | 错误日志、图形上下文及资源压力 |
限制与边界
- MDN 的 WebGL 指南强调资源预算与设备差异；增加服务器配置不能直接解决用户终端的图形资源不足。
- 不要提交未脱敏的敏感模型到公共反馈渠道。修复后要在原终端和原任务上复测，不能只用小样本证明全量模型已解决。
引用资料
以下资料用于核对标准概念或当前产品路径；本文操作顺序与检查清单为慧筑针对该问题整理的实施建议。
相关问题与下一步
本次实质更新
首次发布分层排障、对照验证和问题材料清单。