Autodesk APS对象树获取失败问题咨询与诊断请求

问题现象 #

• 上传至APS的DWFX文件可通过Viewer正常查看3D模型、对象树及属性，但调用API获取对象树时返回error 404 {"diagnostic":"Failed to query the data."}
• 早期上传的文件无此问题，所有新上传文件均出现相同错误
• 使用.NET 9应用（依赖Autodesk.ModelDerivative包2.2.0）调用ModelDerivativeClient.GetObjectTreeAsync()失败，数周前该应用运行正常
• 直接通过curl调用/modelderivative/v2/designdata/{urn}/metadata/{modelGuid}接口也返回相同错误
• 存储桶位于美国区域，Flexi Token余额充足，文件转换任务状态显示完成，操作流程未发生变更

诊断步骤 #

1. 校验模型GUID有效性

   • 从GetManifestAsync()返回的清单中，确认modelGuid对应DWFX的主几何视图节点，部分DWFX可能包含多个视图（如布局、预览图），需选择带有几何数据的节点
   • 检查GUID大小写，APS API对GUID大小写敏感，需严格匹配清单中的值

2. 查看转换日志

   • 调用GET /modelderivative/v2/designdata/{urn}/manifest/{derivativeUrn}/log接口，检查转换过程中是否存在文件损坏、几何数据解析失败等警告或错误

3. 排查文件兼容性

   • 测试不同版本工具导出的DWFX文件，对比新旧文件的导出设置（如是否启用压缩、是否包含外部参照），排除文件本身格式问题

4. 验证Token权限

   • 确保请求使用的Token包含data:read权限，且未过期；权限不足会导致数据查询失败，与Flexi Token余额无关

APS API近期变更说明 #

近期Model Derivative API未发布影响对象树获取的核心功能变更，但需注意：

• 旧版SDK（如2.2.0）可能存在兼容性问题，建议升级至最新稳定版（当前为3.x系列）
• 美国区域服务可能存在临时缓存同步延迟，转换完成后建议等待5-10分钟再调用对象树接口

上传文件并获取对象树的最新.NET示例 #

1. 初始化客户端 #

using Autodesk.Forge;
using Autodesk.Forge.Model;

var clientId = "你的客户端ID";
var clientSecret = "你的客户端密钥";

// 获取2-legged Token
var authClient = new TwoLeggedApi();
var authResponse = await authClient.AuthenticateAsync(
    clientId,
    clientSecret,
    new List<string> { "data:read", "data:create", "bucket:create", "bucket:read" }
);

// 初始化Model Derivative客户端
var derivativeClient = new ModelDerivativeApi();
derivativeClient.Configuration.AccessToken = authResponse.access_token;

2. 上传文件并触发转换 #

// 上传文件到OSS存储桶
var ossClient = new OssApi();
ossClient.Configuration.AccessToken = authResponse.access_token;
var bucketKey = "你的存储桶Key";
var localFilePath = "本地DWFX文件路径";

using var fileStream = File.OpenRead(localFilePath);
await ossClient.UploadObjectAsync(bucketKey, Path.GetFileName(localFilePath), (int)fileStream.Length, fileStream);

// 生成URL安全的URN
var urn = GetUrlSafeBase64(Path.GetFileName(localFilePath));

// 发起转换任务（使用推荐的SVF2格式）
var jobPayload = new JobPayload(
    new JobInput(urn),
    new JobOutput(new List<JobOutputItem> 
    { 
        new JobOutputItem(JobOutputItem.TypeEnum.Svf2, new List<string> { "2d", "3d" }) 
    })
);

await derivativeClient.TranslateAsync(jobPayload);

3. 等待转换完成并获取对象树 #

// 轮询转换状态
Manifest manifest;
do
{
    manifest = await derivativeClient.GetManifestAsync(urn);
    await Task.Delay(5000); // 每5秒查询一次
} while (manifest.Status is Manifest.StatusEnum.InProgress or Manifest.StatusEnum.Pending);

// 提取主3D模型的GUID
var modelGuid = manifest.Derivatives
    .First(d => d.Type == "geometry")
    .Children
    .First(c => c.Role == "3d")
    .Guid;

// 获取对象树
var objectTree = await derivativeClient.GetObjectTreeAsync(urn, modelGuid);
Console.WriteLine("对象树数据：" + objectTree.ToString());

辅助方法：URL安全Base64编码 #

private static string GetUrlSafeBase64(string input)
{
    var bytes = System.Text.Encoding.UTF8.GetBytes(input);
    return Convert.ToBase64String(bytes)
        .Replace('+', '-')
        .Replace('/', '_')
        .TrimEnd('=');
}

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