MULTIPLE_SUBGRAPHS

当你在节点内调用子图多次，且子图使用 checkpointer=True（延续模式）编译时，会发生此错误。

故障排除

根据你的需求选择以下方法之一：

1. 不需要中断？ 使用 checkpointer=False 完全退出检查点功能：

   subgraph = subgraph_builder.compile(checkpointer=False)
   

2. 需要中断但不需要跨调用持久化？ 通过省略 checkpointer 使用默认继承模式：

   subgraph = subgraph_builder.compile()
   

   每次调用都会获得一个唯一的命名空间，因此并行执行可以正常工作。子图每次都从头开始，但可以使用 interrupt()。

3. 需要跨调用持久化？ 使用 checkpointer=True。LangGraph 会为每次调用分配一个基于位置的命名空间后缀（calling_node、calling_node|1 等）以防止冲突。要获得稳定的、基于名称的命名空间，请用唯一的节点名称包装每个子图——参见并行子图。

相关内容

• 子图持久化 — 检查点器模式的完整对比
• 持久化 — 检查点器在 LangGraph 中的工作原理

---

将这些文档连接到 Claude、VSCode 等工具，通过 MCP 获取实时答案。

在 GitHub 上编辑此页面或提交 issue。