关于Autodesk翻译API返回Possibly recoverable warning错误的咨询

问题背景 #

上传STEP文件到OSS存储时API响应正常：

上传文件API响应：

{
    "bucketKey": "suresh_ferzia_india_120",
    "objectId": "urn:adsk.objects:os.object:suresh_ferzia_india_120/:delman.stp",
    "objectKey": ":delman.stp",
    "sha1": "4e0bb47f3c7e1fd22138040bde9e9be130ea2095",
    "size": 930988,
    "contentType": "application/octet-stream",
    "location": "https://developer.api.autodesk.com/oss/v2/buckets/suresh_ferzia_india_120/objects/:delman.stp"
}

但调用Get Manifest API获取翻译状态时返回失败：

翻译状态API响应：

{
    "urn": "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c3VyZXNoX2ZlcnppYV9pbmRpYV8xMjAvOmRlbG1hbi5zdHA",
    "derivatives": [
        {
            "hasThumbnail": "false",
            "name": "_delman.stp",
            "progress": "complete",
            "messages": [
                {
                    "type": "error",
                    "message": "Possibly recoverable warning exit code from extractor: -536870943",
                    "code": "TranslationWorker-RecoverableInternalFailure"
                }
            ],
            "outputType": "svf",
            "status": "failed"
        }
    ],
    "hasThumbnail": "false",
    "progress": "complete",
    "type": "manifest",
    "region": "US",
    "version": "1.0",
    "status": "failed"
}

错误解析 #

• 错误码TranslationWorker-RecoverableInternalFailure和退出码-536870943（对应Windows错误码0xE0000201），本质是Forge的STEP文件解析器在处理文件时遇到了可恢复但最终导致翻译失败的内部问题。
• 常见触发原因：
  • STEP文件本身存在数据缺陷，比如几何拓扑错误、不规范的实体定义、缺失必要的属性信息；
  • 文件版本与Forge解析器兼容度差，比如使用了较新/较旧的STEP协议版本，解析器无法正确识别；
  • 文件命名包含特殊字符（比如你的文件名是:delman.stp，冒号属于特殊字符，可能导致解析器读取文件时出现异常）。

建议解决方向 #

• 先修改文件名，移除冒号这类特殊字符，重新上传并发起翻译；
• 使用CAD软件（如SolidWorks、AutoCAD）打开原STEP文件，修复其中的几何错误后重新导出；
• 尝试导出为其他兼容格式（如IGES）再上传翻译，对比是否能成功；
• 若以上方法无效，可提交文件到Autodesk技术支持排查具体解析问题。

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