LangChain 常见错误与排查

提示输入错误通常来自模板变量缺失、花括号未转义或输入类型不符。工具结果错误通常来自工具消息数量、顺序或 tool_call_id 与模型请求不匹配。消息转换失败表示传入对象无法被规范化为受支持消息。

模型认证、模型不存在和速率限制属于提供商调用层。排查时应核对凭据来源、端点、模型名、账户权限、区域、配额和重试头，避免把权限错误无限重试。

输出解析失败表示模型输出不符合解析器预期。优先使用提供商原生结构化输出或工具策略，并记录原始响应；不要通过宽泛字符串修补掩盖 Schema 或提示设计问题。

排查记录至少保留异常类型、运行标识、模型与版本、消息摘要、工具调用 ID 和重试次数，同时对敏感内容做脱敏。

官方错误索引：INVALID_PROMPT_INPUT、INVALID_TOOL_RESULTS、MESSAGE_COERCION_FAILURE、MODEL_AUTHENTICATION、MODEL_NOT_FOUND、MODEL_RATE_LIMIT、OUTPUT_PARSING_FAILURE。