> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-docs-zh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 多个子图

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

[当在节点](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/use-subgraphs.md#在节点中调用子图)内多次调用子图且子图以`checkpointer=True`（持续模式）编译时，会出现此错误。

## 排查与修复

根据需求选择以下方案：

:::python

1. **不需要中断？** 使用`checkpointer=False`完全禁用检查点：
   ```python theme={null}
   subgraph = subgraph_builder.compile(checkpointer=False)
   ```

2. **需要中断但不需要跨调用持久化？** 使用默认继承模式（省略`checkpointer`）：
   ```python theme={null}
   subgraph = subgraph_builder.compile()
   ```
   每次调用获得唯一命名空间，支持并行执行。子图每次启动时重置但可使用`interrupt()`。

3. **需要跨调用持久化？** 使用`checkpointer=True`。LangGraph为每次调用分配基于位置的命名空间后缀（`calling_node`, `calling_node|1`等）防止冲突。如需稳定的名称化命名空间，可将每个子图包裹在唯一节点名称中——详见[并行子图](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/use-subgraphs.md#子图持久化)。
   :::

:::js

1. **不需要中断？** 使用`checkpointer: false`完全禁用检查点：
   ```typescript theme={null}
   const subgraph = subgraphBuilder.compile({ checkpointer: false });
   ```

2. **需要中断但不需要跨调用持久化？** 使用默认继承模式（省略`checkpointer`）：
   ```typescript theme={null}
   const subgraph = subgraphBuilder.compile();
   ```
   每次调用获得唯一命名空间，支持并行执行。子图每次启动时重置但可使用`interrupt()`。

3. **需要跨调用持久化？** 使用`checkpointer: true`。LangGraph为每次调用分配基于位置的命名空间后缀（`calling_node`, `calling_node|1`等）防止冲突。如需稳定的名称化命名空间，可将每个子图包裹在唯一节点名称中——详见[并行子图](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/use-subgraphs.md#子图持久化)。
   :::

## 相关

* [子图持久化](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/use-subgraphs.md#子图持久化) — 检查点模式的完整对比
* [持久化](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/persistence.md) — LangGraph中检查点的工作原理

***

> 官方原文：[src/oss/langgraph/errors/MULTIPLE\_SUBGRAPHS.mdx](https://github.com/langchain-ai/docs/blob/main/src/oss/langgraph/errors/MULTIPLE_SUBGRAPHS.mdx) · 非官方翻译，译文由 AI 生成，以英文原文为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.