关于APS Viewer校准不一致及大文件上传失败的技术问询

我们（ATOM）正在开发一款集成Autodesk APS的建筑技术平台，用于处理和可视化场地数据。工作流中，使用APS Viewer向客户展示带有参考正射影像的DWG文件，支持客户通过测量工具评估项目施工精度与质量。开发过程中遇到以下两个问题，恳请提供解决方案：

问题1：Viewer校准不一致导致测量结果偏差 #

将包含参考.tif（正射影像）的DWG文件以ZIP压缩包形式上传至Viewer时，校准信息损坏，DWG内容与正射影像各自应用独立的校准设置，导致相同长度在两者上测量结果不一致。

解决方案建议： #

• 检查ZIP包内文件结构：确保DWG与正射影像的关联校准文件（如.tfw、.prj）与对应文件同目录，且文件名完全匹配（例如site.tif对应site.tfw），压缩时避免嵌套多余文件夹层级。
• 预验证校准参数：上传前通过AutoCAD打开DWG，确认正射影像的附着校准参数（坐标系统、缩放比例等）已正确嵌入，避免外部链接丢失。
• 规范上传配置：使用APS Data Management API的upload接口时，将ZIP包的MIME类型设置为application/zip，防止解析时出现格式识别错误。
• 排除压缩影响：尝试单独上传DWG和正射影像文件，而非压缩包，验证是否为压缩过程导致校准信息丢失，再排查压缩工具或参数问题。

问题2：大ZIP文件上传超时/403错误 #

使用OssClient服务向APS存储桶上传大于200MB的ZIP文件时，频繁出现超时或403错误，需多次重试才能成功。

解决方案建议： #

• 启用分块上传：APS存储桶支持分块上传（Multipart Upload），将大文件分割为10MB-5GB的块（推荐20MB-100MB），通过OssClient的分块上传接口实现，避免单次请求超时。
• 调整超时参数：在OssClient配置中延长连接超时（connectTimeout）和读取超时（socketTimeout）至300秒以上，适配大文件传输的耗时需求。
• 排查权限问题：通过APS控制台日志查看403错误的具体原因，确保上传使用的Token包含data:write权限，且存储桶的跨域设置（CORS）允许当前客户端的请求来源。
• 最佳实践：
  • 上传前通过APS API获取存储桶的专属上传URL，减少网络跳转延迟。
  • 实现断点续传机制，针对上传失败的块单独重试，提升大文件上传稳定性。
  • 避开网络高峰时段上传，或借助CDN加速上传链路。

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