LangGraph4j

LangGraph4j 是面向 Java 生态的有状态多智能体工作流编排框架，核心设计源自 Python 版 LangGraph。框架以有环有向图（非限于 DAG）作为执行模型，通过 StateGraph 定义节点与边，以 AgentState + Channel Reducer 模式管理节点间共享状态，支持覆盖、追加、消息去重等多种状态合并策略。

在控制流方面，提供无条件边、条件路由边和条件入口点三种边类型，并支持子图以 StateGraph、CompiledGraph 或 NodeAction 三种方式嵌入组合，以及并行分支执行。执行层面同时支持同步（NodeAction）与异步（AsyncNodeAction + CompletableFuture）节点，并可通过 AsyncGenerator 实现 LLM 响应的实时流式输出。

框架内置 Checkpoint 机制，可在任意超级步保存和恢复图状态，提供 Memory、MySQL、PostgreSQL、Oracle、Redis 五种持久化后端，支持 Time-Travel Debugging（浏览历史 checkpoint 并回放）和 Human-in-the-Loop（在指定中断点暂停工作流等待人工审批）。可观测性方面集成 OpenTelemetry 并提供 Hook 扩展机制，图结构支持 PlantUML 和 Mermaid 两种可视化格式，另附 Studio Web UI（Jetty/Quarkus/Spring Boot 三种服务端）用于可视化运行和调试。

LLM 接入通过集成模块实现：与 Langchain4j 集成提供 langchain4j-core + langchain4j-agent，与 Spring AI 集成提供 spring-ai-core + spring-ai-agent，各自包含 Agent Executor。核心模块要求 Java 17+，当前稳定版本 1.8.15，通过 Maven Central 分发（groupId: org.bsc.langgraph4j）。

多模块项目结构：

langgraph4j/
├── langgraph4j-bom/                  # BOM 依赖管理
├── langgraph4j-core/                 # 核心执行引擎
├── langgraph4j-opentelemetry/        # 可观测性
├── langgraph4j-mysql-saver/          # MySQL Checkpoint
├── langgraph4j-oracle-saver/         # Oracle Checkpoint
├── langgraph4j-postgres-saver/       # PostgreSQL Checkpoint
├── langgraph4j-redis-saver/          # Redis Checkpoint
├── langchain4j/                      # LangChain4j 集成
├── spring-ai/                        # Spring AI 集成
├── studio/                           # Studio Web UI
├── how-tos/                          # 交互式教程（需 Java 22）
├── samples/                          # 示例代码
├── javelit/                          # Javelit UI 集成
└── generator/                        # 代码生成器

Maven 依赖（BOM 方式）：

<properties>
    <langgraph4j.version>1.8.15</langgraph4j.version>
</properties>
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.bsc.langgraph4j</groupId>
      <artifactId>langgraph4j-bom</artifactId>
      <version>${langgraph4j.version}</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>
<dependencies>
    <dependency>
        <groupId>org.bsc.langgraph4j</groupId>
        <artifactId>langgraph4j-core</artifactId>
    </dependency>
</dependencies>

待确认信息：文档站线上 URL 未在提取材料中完整显示；Langchain4j 兼容版本范围待确认（pom.xml 中为 1.13.0）；Spring AI 集成版本为 2.0.0-M4（Milestone 预发布版），生产可用性待确认；README 中 Release 日期显示 "May 7, 2026"，与当前时间线不符，可能为笔误或占位符。