Autodesk Viewer故障：请求/modeldata/manifest/返回401未授权错误

1. 验证Access Token的有效性与权限 #

• 用JWT解析工具解析当前使用的access token，确认payload中的scopes包含data:read，且token未过期
• 直接调用Forge OSS API验证token：执行curl -H "Authorization: Bearer {YOUR_TOKEN}" https://developer.api.autodesk.com/oss/v2/buckets，若返回正常则token本身有效，否则检查token生成/刷新逻辑
• 检查autoRefresh机制是否正常工作：确认数据库中存储的token是最新的，而非过期旧token，排查getAutodeskClient中token刷新逻辑是否存在异常

2. 确认URN的正确性 #

• 验证传入的URN是标准Base64URL编码（无多余填充字符，替换+为-、/为_），对比官方viewer使用的URN是否完全一致
• 确保URN未被错误拼接（如重复添加urn:前缀），检查launchViewer中documentId的生成逻辑

3. 检查Viewer的Token传递逻辑 #

• 确认getForgeToken函数返回格式符合要求：需返回Promise，resolve的对象包含access_token和expires_in字段，示例正确实现：

function getForgeToken(callback) {
  // 从后端获取最新token的逻辑
  fetch('/api/get-token')
    .then(res => res.json())
    .then(data => callback(data.access_token, data.expires_in));
}

• 查看浏览器控制台网络请求，检查modeldata/manifest请求的Authorization头是否为Bearer {正确的token}，排查是否存在token被截断、丢失或错误传递的情况

4. 确认文件的用户权限归属 #

• 验证当前认证用户对该模型文件拥有访问权限：若文件属于团队资源，确认用户未被移除团队，或文件权限未被修改
• 对比官方viewer的登录用户与应用的认证用户是否为同一账号，排除跨用户权限问题

5. 排查服务与版本兼容性 #

• 检查Autodesk Forge官方状态通知，确认相关服务无临时故障
• 尝试升级Forge SDK与Viewer至最新版本，排查旧版本兼容性问题

6. 检查CORS与请求干扰因素 #

• 确认后端CORS配置允许Viewer相关域名的请求，避免请求头被拦截
• 禁用浏览器插件、代理工具，排查是否有外部工具修改了请求头导致Authorization丢失

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