驯服RPC_E_CALL_REJECTED:深入CAD-MCP的COM瞬态错误重试机制

原创2026-11-04 14:42:242,161 阅读

驯服RPC_E_CALL_REJECTED:深入CAD-MCP的COM瞬态错误重试机制

CAD-MCP 是一个基于 MCP 协议(Model Context Protocol)的 CAD 控制服务,让 AI 通过自然语言指令自动控制 AutoCAD、浩辰 CAD、中望 CAD 完成绘图。但用 Windows COM 接口驱动 CAD 时,最常"翻车"的敌人就是 RPC_E_CALL_REJECTED——CAD 正忙,拒绝你的调用。本文带你深入 CAD-MCP 的 COM 瞬态错误重试机制,看懂它如何让 AI 操作 CAD 时不再"掉线"。

CAD-MCP 通过 COM 接口自动控制 AutoCAD 完成 AI 绘图演示

上图展示了 CAD-MCP 的实际效果:AI 助手在右侧对话框接收指令,左侧 AutoCAD 自动完成绘图,全程无需人工操作鼠标。

RPC_E_CALL_REJECTED 是什么错误?

RPC_E_CALL_REJECTED(错误码 -2147418111)是 Windows COM 体系中的一个典型瞬态错误:当 CAD 正在执行命令、弹出对话框或重生成视图时,它处于"忙碌"状态,会短暂拒绝外部 COM 调用。

关键点在于:被拒绝的调用并没有执行,而且这个忙碌状态通常只持续几秒。稍等片刻再发同样的调用,就能成功。这正是"可重试错误"和"致命错误"的本质区别——前者重试即可恢复,后者重试一百次也没用。

CAD-MCP 在 src/cad_controller.py 中明确定义了这类瞬态错误:

错误 错误码 含义 是否可重试
RPC_E_CALL_REJECTED -2147418111 CAD 忙碌,拒绝 COM 调用 ✅ 是
AutoCAD 保存冲突 -2145320861 保存/打开进行中,SaveAs 报"保存文档时出错" ✅ 是
RPC_E_DISCONNECTED -2147417848 CAD 进程已关闭,接口指针失效 ❌ 否
RPC_S_SERVER_UNAVAILABLE -2147023174 RPC 服务器不可用 ❌ 否

💡 一个容易踩的坑:AutoCAD 的瞬态保存错误藏在 com_error 的 excepinfo 元组里,直接看 hresult 是发现不了的,CAD-MCP 因此在判断逻辑中做了双重检查(见 cad_controller.py)。

设计要点一:重试粒度必须在"调用级",而不是"方法级"

这是整套机制里最值得借鉴的一条经验。直觉上,失败就把整个绘图方法重跑一遍似乎没问题,但 CAD-MCP 在源码注释中点破了隐患:

CAD 忙碌时调用被拒绝意味着该调用未执行,对单个 COM 调用重试是安全的;对整个业务方法重试则可能重复绘制——方法前半段已成功、后半段被拒的场合。 —— cad_controller.py

举个例子:draw_rectangle 内部要画 4 条线,假设前 3 条成功、第 4 条被拒。如果重试整个方法,图纸上就会出现一个完整的矩形加上 3 条重复的"残影线"。而只重试被拒绝的那一次 AddLine 调用,由于调用本身没执行过,重试是完全安全的。

因此 CAD-MCP 所有绘图、编辑操作都拆成一个个独立的 COM 调用,每个调用单独包裹在重试器里,粒度精细到"一次属性读取"这种级别。

设计要点二:连"查找属性"也是一次 COM 调用

Windows COM 动态派发模式下还藏着一个更隐蔽的陷阱:obj.SaveAs 中取 SaveAs 这个属性名的过程(GetIDsOfNames)本身就是一次 COM 调用,同样可能被忙碌的 CAD 拒绝。更坑的是,pywin32 会把这次失败"吞掉",转成一个普通的 AttributeError(比如 object has no attribute 'Close'),错误码随之丢失——按常规思路根本看不出这是瞬态错误。

CAD-MCP 的解法是两个:

  • 通过 cad_controller.py 识别 pywin32 转译后的两种 AttributeError 消息格式,把它们也纳入瞬态重试;
  • 用 _call_attr 把"成员查找 + 调用"合并为一个重试单元,确保查找发生在重试保护之内。

设计要点三:核心重试器的参数设计

重试的核心逻辑集中在 _call_with_com_retry 中,规则非常克制:

  • 最多重试 20 次,每次间隔 0.5 秒,总等待上限约 10 秒;
  • 只对瞬态错误重试(忙碌被拒、保存冲突、成员查找被拒),其他异常直接抛出,避免无意义的等待;
  • 超限后抛出原始异常,不掩盖真实错误。

这个"有限次 + 短间隔 + 严格白名单"的组合,比无限重试或一刀切的大 sleep 更稳健:正常忙碌几秒内就能恢复,真正的错误也不会被拖延。

设计要点四:专用 COM 线程让一切串行化

Windows COM 的套间(Apartment)模型要求接口指针必须在创建它的线程上使用,跨线程访问会导致调用失败甚至崩溃。CAD-MCP 用 COMExecutor 解决这个问题:启动一条专用 STA 线程,所有 COM 调用都排队串行执行。

这带来两个额外好处:

  1. 🧵 线程安全:多个 AI 工具并发调用也不会出现跨套间访问问题;
  2. ⚡ 不阻塞事件循环:COM 的阻塞调用(比如等待 CAD 启动的 20 秒)都发生在专用线程上,MCP 服务器本身仍能正常响应其他请求。

致命错误不重试:检测到"死连接"立即重置

只处理瞬态错误还不够。如果用户手动关闭了 CAD 窗口,持有的 COM 引用全部失效,此时重试毫无意义——所有工具会永远报"操作失败"。

CAD-MCP 在 _call 中对这类错误(RPC_E_DISCONNECTED、RPC_S_SERVER_UNAVAILABLE)做了特殊处理:直接重置连接状态(清空 app 和 doc),让下一次操作自动走"重新启动 CAD"的分支,而不是傻等重试。瞬态错误等待、致命错误自愈,两条路径互不干扰。

这套机制如何落地到具体功能?

重试机制贯穿了 CAD-MCP 的全部 35 个工具,举两个典型场景:

  • 保存图纸:save_drawing 中 SaveAs 返回后 CAD 仍可能短暂拒绝后续修改调用,后续工具的 COM 调用会自动重试等待恢复;若目标文件被其他已打开的图纸锁定(这种情况重试 40 秒也没用),则提前检测并快速失败,给出明确提示;
  • 启动 CAD:start_cad 中连 Documents 集合读取、Add 新建文档这类"看似简单"的操作,也都逐一包在调用级重试里。

配合 src/config.json 中的 startup_wait_time(CAD 启动等待秒数)与 command_delay(命令执行延迟)两项配置,可以在不稳定的机器上进一步放宽节奏。

延伸阅读:如何阅读相关源码

想深入理解这套重试机制,建议按以下路径阅读:

总结

CAD-MCP 驯服 RPC_E_CALL_REJECTED 的经验可以浓缩为四条:

  1. 认清错误性质:区分瞬态忙碌(可重试)与连接死亡(应重置),重试白名单严格克制;
  2. 重试粒度下沉到单次 COM 调用,避免整方法重试造成的副作用(重复绘制);
  3. 把"查找属性"也视为 COM 调用,防止动态派发下的瞬态错误被伪装成 AttributeError 漏掉;
  4. 专用 STA 线程串行化所有调用,兼顾 COM 套间模型与异步事件循环。

这些设计让 AI 驱动的 CAD 自动化在真实、忙碌、不确定的 COM 环境中依然稳定可靠——这也是所有"AI + 桌面自动化"项目都该抄的一份作业。

登录后查看全文
CAD-MCP