常见错误

原文：Common Errors

一句话

LangGraph 开发中常见错误的代码列表及解决指南。

什么时候翻这页

当 LangGraph 应用程序运行时出现错误，需要根据错误代码查找解决方案时。

核心概念

• 错误代码系统：每个错误都有一个 lc_error_code 属性，对应特定的错误类型
• 错误分类：错误分为 LangGraph 特有错误和 LangChain 通用错误
• 错误定位：通过错误代码快速定位问题，提高调试效率

怎么做

1. 捕获异常并检查 lc_error_code 属性
2. 根据错误代码查阅对应文档页面
3. 了解具体错误原因和解决方案
4. 修改代码实现或配置参数

命令 / API 速查

• lc_error_code：错误代码属性，用于识别特定错误类型

与 Hello-Agents / Claude Code 的联系

Hello-Agents 中介绍的 LangGraph 基础概念（如 StateGraph、node、edge）是避免这些错误的前提，而 Claude Code 可以帮助调试这些错误。相比 Hello-Agents 的基础介绍，本文档提供了更深入的错误处理指南。

初学者易错点

• 递归限制（GRAPH_RECURSION_LIMIT）：循环调用超过限制
• 无效的图节点返回值（INVALID_GRAPH_NODE_RETURN_VALUE）：节点返回不符合预期的数据结构
• 缺少检查点（MISSING_CHECKPOINTER）：未正确配置 checkpoint 机制
• 无效的并发图更新（INVALID_CONCURRENT_GRAPH_UPDATE）：多线程同时修改图结构

相关词条

• GRAPH_RECURSION_LIMIT
• INVALID_CHAT_HISTORY
• INVALID_CONCURRENT_GRAPH_UPDATE
• INVALID_GRAPH_NODE_RETURN_VALUE
• INVALID_PROMPT_INPUT
• INVALID_TOOL_RESULTS
• MESSAGE_COERCION_FAILURE
• MISSING_CHECKPOINTER
• MODEL_AUTHENTICATION
• MODEL_NOT_FOUND
• MODEL_RATE_LIMIT
• MULTIPLE_SUBGRAPHS
• OUTPUT_PARSING_FAILURE