Autodesk Forge Manifest提示Missing reference缺失参考文件问题咨询

首先明确补充说明的疑问：A.dwg、B.dwg内部未上传的图片引用缺失，完全不会影响C.dwg对这两个DWG文件的引用识别，当前警告仅和C.dwg的DWG类型外部参照匹配逻辑相关，无需在此处耗费排查精力。

排查修复步骤 #

• 核对引用接口的路径匹配规则：调用引用绑定接口时传递的relativePath参数，必须和C.dwg文件内记录的B.dwg参照路径完全一致，包括大小写、路径分隔符（/和\的差异）、路径前缀，即使传递了正确的VersionURN，路径不匹配也会被判定为缺失文件。
• 验证B.dwg的版本URN有效性：确认绑定引用所用的是**版本URN（以versions:开头）**而非对象URN，且对应B.dwg的转换作业状态为success，存储桶权限正常，文件未被删除或覆盖。
• 检查作业触发顺序：必须在A、B全部上传转换完成、且完成引用关系绑定到C.dwg的版本之后，再触发C.dwg的转换作业。如果是先触发转换再补绑引用，需要重新提交一次C.dwg的转换任务，已生成的Manifest不会自动同步后续新增的引用关系。
• 校验DWG内部参照记录：用AutoCAD打开C.dwg，运行XREF命令导出外部参照列表，核对B.dwg的参照名称、存储路径和接口传参是否完全匹配，部分旧版DWG会同时存储绝对路径、相对路径两个参照值，这种情况需要将两个路径都在引用接口中声明对应URN。

同类问题说明 #

该类问题在Forge DWG转换场景中出现频率较高，90%以上的报错都是路径匹配不严格、引用绑定顺序错误导致的，极少数情况是DWG内部参照元数据损坏，可尝试在AutoCAD中重新绑定B.dwg参照后重新导出C.dwg重试。

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