Autodesk Forge wrench示例项目iam文件转换后提示模型为空问题咨询

• 优先检查Model Derivative API转换作业的提交参数：装配体转换必须将generateMasterViews设置为true，wrench示例默认针对IPT零件做的配置通常不会开启该参数，会导致装配体转换后无有效视图输出。
  装配体和零件的转换参数配置存在差异，是该问题最高发的诱因
• 核对上传到OSS的文件完整性：IAM装配体本身不存储子零件实体数据，仅保留引用关系，上传时需要将所有关联的子IPT、子IAM文件和主IAM文件放在OSS存储桶的同一路径下，仅上传单独的IAM文件会导致转换时找不到引用资源，输出空模型。本地Inventor可以正常打开是因为本地环境存在完整的引用文件路径，和云端环境隔离。
• 查看转换作业的详细日志：调用GET /modelderivative/v2/designdata/{urn}/manifest接口获取转换清单，检索messages字段的错误和警告信息，若存在Missing reference类提示即可确认是引用文件缺失导致的问题。
• 用Inventor打包功能重传文件：在本地Inventor中打开目标IAM文件，选择「文件」-「另存为」-「打包」，将所有关联引用、纹理资源统一打包后全部上传到OSS，再重新发起转换作业，避免漏传零散的引用文件。
• 排查前端加载逻辑：wrench示例默认适配单零件模型加载，需确认代码中是否正确遍历了装配体的多节点结构，可在Viewer初始化完成后执行viewer.model.getRoot()打印模型根节点信息，区分是转换阶段输出为空，还是前端未正确读取装配层级。

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