驯服RPC_E_CALL_REJECTED:深入CAD-MCP的COM瞬态错误重试机制
驯服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 的实际效果: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 调用都排队串行执行。
这带来两个额外好处:
- 🧵 线程安全:多个 AI 工具并发调用也不会出现跨套间访问问题;
- ⚡ 不阻塞事件循环: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(命令执行延迟)两项配置,可以在不稳定的机器上进一步放宽节奏。
延伸阅读:如何阅读相关源码
想深入理解这套重试机制,建议按以下路径阅读:
- 📖 COM 瞬态错误定义与判断逻辑:src/cad_controller.py
- 📖 调用级重试入口与死连接处理:src/cad_controller.py
- 📖 专用 COM 线程执行器:src/cad_controller.py
- 📖 完整工具清单与项目结构:README_zh.md
- 📖 MCP 服务器入口(FastMCP 实现):src/server.py
总结
CAD-MCP 驯服 RPC_E_CALL_REJECTED 的经验可以浓缩为四条:
- 认清错误性质:区分瞬态忙碌(可重试)与连接死亡(应重置),重试白名单严格克制;
- 重试粒度下沉到单次 COM 调用,避免整方法重试造成的副作用(重复绘制);
- 把"查找属性"也视为 COM 调用,防止动态派发下的瞬态错误被伪装成
AttributeError漏掉; - 专用 STA 线程串行化所有调用,兼顾 COM 套间模型与异步事件循环。
这些设计让 AI 驱动的 CAD 自动化在真实、忙碌、不确定的 COM 环境中依然稳定可靠——这也是所有"AI + 桌面自动化"项目都该抄的一份作业。
