多个子图

当在节点内多次调用子图且子图以checkpointer=True（持续模式）编译时，会出现此错误。

当在节点内多次调用子图且子图以checkpointer=True（持续模式）编译时，会出现此错误。

排查与修复

根据需求选择以下方案：

:::python

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等）防止冲突。如需稳定的名称化命名空间，可将每个子图包裹在唯一节点名称中——详见并行子图。 :::

:::js

1. 不需要中断？ 使用checkpointer: false完全禁用检查点：

   const subgraph = subgraphBuilder.compile({ checkpointer: false });
   

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

   const subgraph = subgraphBuilder.compile();
   

   每次调用获得唯一命名空间，支持并行执行。子图每次启动时重置但可使用interrupt()。

3. 需要跨调用持久化？ 使用checkpointer: true。LangGraph为每次调用分配基于位置的命名空间后缀（calling_node, calling_node|1等）防止冲突。如需稳定的名称化命名空间，可将每个子图包裹在唯一节点名称中——详见并行子图。 :::

相关

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

---

官方原文：src/oss/langgraph/errors/MULTIPLE_SUBGRAPHS.mdx · 非官方翻译，译文由 AI 生成，以英文原文为准。