PlotToPDF设计自动化部分任务失败，求原因排查及超限解决方案

问题描述 #

执行PlotToPDF设计自动化任务时，部分任务启动约12分钟后失败，仅显示「Failed Instructions」错误。使用自定义活动指定目标布局并加载特定.ctb文件，其他图纸执行相同逻辑可成功，已将limitProcessingTimeSec设置为1小时。需解决两个问题：

1. 如何确认错误原因？
2. 已知limitTotalUncompressedAppsSizeInMB无法通过API修改，若图纸及所有XREF超出配额限制，有哪些解决办法？

一、排查「Failed Instructions」错误原因的方法 #

• 查看完整任务日志：在设计自动化控制台的任务详情页，获取包含引擎输出、自定义活动调试信息的完整日志，重点关注失败前1-2分钟的条目，通常能找到.ctb加载失败、布局访问异常、XREF解析错误等具体原因。
• 本地复现验证：将出错的图纸、.ctb文件及关联XREF复制到本地AutoCAD环境，手动执行相同的PlotToPDF操作，观察是否出现弹窗提示或命令行报错（比如.ctb路径无效、布局内存在损坏对象）。
• 校验输入参数：确认自定义活动中指定的布局名称与图纸内名称完全匹配（区分大小写），.ctb文件在任务执行环境中的路径可访问、无拼写或权限问题。
• 添加调试日志：在自定义活动代码中增加日志输出，记录布局加载状态、.ctb加载结果、XREF加载进度等信息，写入任务输出文件，辅助定位问题。

二、图纸及XREF超出配额限制的解决办法 #

• 清理图纸冗余：用AutoCAD的PURGE命令清理未使用的图层、块、样式等对象，AUDIT命令修复损坏数据，减少无效体积占用。
• 优化XREF引用：
  • 删除不必要的XREF，仅保留当前布局所需的外部参照。
  • 将嵌套XREF转换为块，减少层级，降低整体解压体积。
  • 单独对XREF文件执行清理优化后再重新引用。
• 压缩上传文件：上传前将图纸和XREF打包为ZIP压缩格式，设计自动化服务会自动解压，压缩文件能有效降低传输与存储占用，缓解解压后的体积压力。
• 拆分任务处理：若图纸包含多布局，将任务拆分为多个子任务，每个子任务处理单个布局及对应必要XREF，避免单任务加载过多大体积文件。

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