Autodesk Forge API MissingOrInvalidParts报错原因及解决方案

该报错是Autodesk Forge OSS分片上传流程中的典型校验错误，触发逻辑为调用上传完成接口时，服务端无法匹配到上报的全部有效分片：要么部分分片未成功上传至服务端，要么上报的分片ETag、分片序号与服务端实际接收的分片信息不一致，导致服务端无法完成分片拼接生成完整文件。下载得到的1KB文件是上传流程未完成时生成的占位残片，与该报错的触发逻辑完全吻合。

• 校验分片大小规则：Forge OSS要求除最后一个分片外，其余所有分片大小不得小于5MB，若切分的非末尾分片大小低于该阈值，会被服务端直接判定为无效分片，触发报错。
• 核对分片上报参数：每成功上传一个分片，服务端都会返回对应分片的专属ETag值，需严格按照分片上传的序号顺序记录所有返回的ETag，最终调用完成上传接口时，必须按顺序传入全部服务端返回的ETag，不得缺漏、不得打乱顺序、不得使用本地自行计算的ETag值代替服务端返回值。
• 排查单分片上传异常：逐个检查每个分片上传请求的返回状态，确认不存在超时、跨域拦截、权限失效、请求被截断的问题，只要存在一个分片未上传成功，最终完成接口就会校验失败。
• 小文件简化上传流程：若待上传的源文件大小小于50MB，可直接走单请求简单上传接口，无需走分片上传流程，从根源上规避分片校验相关问题。

• 官方分步实操教程：覆盖从应用创建、OSS上传、模型转换触发、元数据提取到视图加载的全流程步骤，每个操作节点都附带可直接参考的请求样例，是最权威的入门材料。
• 官方多语言SDK配套示例：官方提供的Python、Node.js、C#、Java等常用语言SDK中，都附带Model Derivative全流程的可运行Demo，替换自身应用密钥即可快速跑通流程，适合工程化对接参考。
• 开发者社区故障排查手册：官方开发者社区整理了上传、转换、数据提取全链路的常见报错触发场景和修复方案，遇到问题可优先对照排查。

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