BIM360 Issues API返回'user not found'及令牌调用异常求助

问题1：运行数月的Issues API突然无法调用（返回"User not found"） #

排查与解决： #

• 检查用户身份有效性：
  别只看权限，先确认3-legged token绑定的用户账号是否还能正常使用——直接用该账号登录BIM360网页端，验证能否进入目标项目、查看Issues模块。如果账号被删除、禁用，或是被移出项目，就算刷新令牌也无法正常调用。去BIM360项目成员列表确认，该用户需处于活跃状态，且拥有项目查看及以上权限。
• 核对令牌权限范围：
  解码3-legged token，查看scope字段是否包含data:read——Issues API必须依赖该权限。如果之前的授权scope被修改，会直接导致调用失败。重新生成令牌时，务必将data:read纳入权限范围。
• 确认API端点正确性：
  已知v1版本已废弃，调用v2版本时需使用正确路径：GET /issues/v2/containers/{containerId}/quality-issues，避免沿用v1的旧路径。

问题2：3-legged token调用GET /hubs返回空数据，2-legged token正常 #

排查与解决： #

• 检查用户的Hub级权限：
  2-legged token是应用级权限，可访问应用有权限的所有Hub；但3-legged token是用户级权限，仅能访问该用户有权限的Hub。登录BIM360 Account Admin页面，确认该用户是否在目标Hub的成员列表中，且拥有Hub查看及以上权限——若未加入对应Hub，必然返回空数据。
• 验证令牌受众（aud）配置：
  解码令牌查看aud字段，确认其值为https://developer.api.autodesk.com。受众配置错误会导致权限验证不通过，进而返回空数据。
• 重新生成全新令牌：
  不要仅刷新令牌，直接走完整的OAuth授权流程生成新的3-legged token，同时清理流水线中的令牌缓存——部分场景下缓存延迟会导致旧权限状态持续生效。

通用验证步骤 #

• 用JWT解码工具本地解析令牌，检查exp（过期时间）、iss（签发方）、scope、aud等字段是否符合要求。
• 新建测试用户，添加到目标Hub和项目，生成3-legged token后调用API，验证是否为原用户的身份问题。
• 查看Autodesk开发者控制台的服务状态页，确认BIM360 API是否存在临时故障。

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