Skip to main content
LangGraph StateGraph 收到了来自多个节点对其状态属性的并发更新，而该属性不支持此操作。 出现这种情况的一种方式是，如果你在图中使用 fanout 或其他并行执行，并且你定义了一个如下所示的图： 
import { StateGraph, StateSchema, START } from "@langchain/langgraph";
import { z } from "zod/v4";

const State = new StateSchema({
  someKey: z.string(),
});

const builder = new StateGraph(State)
  .addNode("node", (state) => {
    return { someKey: "some_string_value" };
  })
  .addNode("otherNode", (state) => {
    return { someKey: "some_string_value" };
  })
  .addEdge(START, "node")
  .addEdge(START, "otherNode");

const graph = builder.compile();
如果上图中的一个节点返回 { someKey: "some_string_value" }，这将用 "some_string_value" 覆盖 someKey 的状态值。 然而，如果在单个步骤中的多个节点（例如 fanout）返回 someKey 的值，图将抛出此错误，因为关于如何更新内部状态存在不确定性。 为了解决这个问题，你可以定义一个 reducer 来合并多个值： 
import { StateSchema, ReducedValue } from "@langchain/langgraph";
import { z } from "zod/v4";

const State = new StateSchema({
  someKey: new ReducedValue(  
    z.array(z.string()).default(() => []),
    {
      inputSchema: z.array(z.string()),
      reducer: (existing, update) => existing.concat(update),
    }
  ),
});
这将允许你定义逻辑来处理并行执行的多个节点返回的相同键。

​
故障排除

以下内容可能有助于解决此错误：
  • 如果你的图并行执行节点，请确保你为相关状态键定义了 reducer。
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.