使用Forge View BIM 360 & Fusion models示例加载模型报403错误

1. 403 Unauthorized错误排查方向 #

• 核对3条腿OAuth令牌的权限范围：确认申请令牌时是否包含data:read、viewables:read两个必填权限，仅数据管理类权限不足以加载模型视图，必须额外追加viewables:read权限
• 核对项目级应用授权：你在Forge平台创建的应用，需要被对应BIM 360/ACC项目的管理员手动添加到项目的「自定义集成」列表中，否则即使令牌权限正确，也会被项目权限拦截返回403
• 核对URN编码格式：确认拿到的版本URN已经做了Base64安全编码（替换+为-、/为_、删除末尾的=补位字符），错误的URN编码也会触发权限类报错
• 核对令牌有效性：调用launchViewer时使用的令牌是否已过期，确保前端获取的令牌和数据管理接口使用的是同一条有效的3条腿令牌
• 核对区域配置：如果测试的是ACC/BIM 360 US以外区域的项目，需要在所有接口请求头中添加x-ads-region: EMEA（对应欧洲区）或对应区域标识，跨区域请求也会返回403错误

2. viewableId为undefined问题排查方向 #

• 核对manifest解析逻辑：调用GET /modelderivative/v2/designdata/:urn/manifest接口获取转换清单后，需要遍历manifest中的derivatives -> children层级提取可用的viewableId，确认你的代码是否有完整的manifest遍历逻辑
• 核对模型转换状态：如果是首次上传的新文件，Model Derivative服务还未完成格式转换时，manifest中没有可用视图，会导致viewableId为空。你可以先调用Manifest接口查询转换状态，状态为success后再尝试提取viewableId
• 适配多格式解析逻辑：PDF文件的manifest结构和RVT不同，视图信息存储在role: "pdf"的衍生节点下，需要调整遍历逻辑适配不同格式的节点结构

3. 易遗漏配置项核对 #

• 确认Forge应用类型为「Web Application」，且配置的回调地址和你运行的服务地址完全一致，端口号也不能有差异
• 确认前端Viewer初始化时传入的是正确的accessToken参数，不要误传客户端密钥等其他凭证

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