Blender导出glTF模型无法被GLTF Loader直接加载的配置问题求助

问题表现 #

• Blender直接导出的glTF模型无法被GLTFLoader正常加载，必须经过Three.js编辑页重新导出才能使用
• 官方glTF示例模型加载运行正常，仅Blender导出的文件触发控制台报错
  
  
  

排查修复步骤 #

按优先级核对以下导出配置，这类问题基本都是配置错漏导致的：

• 先核对导出格式：如果前端加载逻辑没做分离资源处理，不要选glTF Separate (.gltf + .bin + textures)格式，优先选glTF Binary (.glb)单文件格式，分离格式下.bin文件、纹理文件只要路径不对就会直接加载失败。
• 几何数据项必须勾选应用修改器：没应用的修改器会导致导出的网格数据结构异常，Loader直接解析失败。
• 材质项不要勾仅导出原始材质：Blender自带的非PBR材质节点glTF标准不支持，Three.js识别不了；同时取消勾选导出所有材质槽，空材质槽也会触发解析报错。
• 变换项必须勾选+Y轴向上：Three.js默认坐标系是Y轴向上，Blender默认是Z轴向上，不做坐标轴转换不仅会导致模型朝向不对，部分版本GLTFLoader会直接抛出矩阵异常错误。
• 核对导出范围：确认你选的是导出选中对象还是整个场景，如果场景里有空对象、灯光、相机这类非网格内容，又没开对应导出选项，会出现数据块缺失报错。
• 扩展项不要乱开压缩：新手阶段先把Draco压缩、Meshopt压缩这类扩展全关了，这些压缩格式需要前端额外引入对应的解码Loader，没引的话加载直接报错，等模型能正常打开了再按需开压缩。

快速校验技巧：导出前全选所有模型，按Ctrl+A应用全部位置、旋转、缩放变换，把所有修改器手动应用一遍，材质统一换成glTF兼容的Principled BSDF节点，用默认导出配置重新导出，90%以上的解析问题都能直接解决。

内容的提问来源于stack exchange，提问作者Pong