---
title: 错误类型
---

本文总结了不同类型节点可能发生的异常和对应的错误类型。

### 通用错误

*   系统错误（System Error）

    通常由系统问题引起，例如沙盒服务未开启、网络连接异常等。
*   操作错误（Operational Error）

    应用开发者无法正常配置或运行节点时发生的错误。

### 代码节点

[代码节点](https://docs.dify.ai/guides/workflow/node/code) 支持运行 Python 和 JavaScript 代码，用于在工作流或聊天流中对数据进行改造。以下是常见的 4 种运行错误：

1.  **代码节点错误（CodeNodeError）**

    此错误是由于开发者编写代码中的异常引起的，例如：缺少变量、计算逻辑错误、将字符串数组输入作为字符串变量处理等。你可以通过错误信息和精确的行号定位问题。



    ![代码错误](https://assets-docs.dify.ai/2024/12/c86b11af7f92368180ea1bac38d77083.png)
2.  **沙盒网络问题（System Error）**\
    此错误常见于网络流量或连接异常时，例如沙盒服务未开启，代理服务中断了网络。你可以通过以下方式解决：

    1. 检查网络服务质量
    2. 开启沙盒服务
    3. 验证代理设置



    ![沙盒网络问题](https://assets-docs.dify.ai/2024/12/d95007adf67c4f232e46ec455c348e2c.PNG)
3.  **深度限制错误（DepthLimitError）**

    当前节点的默认配置最多仅支持 5 层嵌套结构。如果超过 5 层，则会报错。



    ![OutputValidationError](https://assets-docs.dify.ai/2024/12/5649d52a6e80ddd4180b336266701f7b.png)


4.  **输出验证错误（OutputValidationError）**

    如果实际输出变量类型与所选输出变量类型不一致将报错。开发者需要更改所选的输出变量类型规避此问题。



    ![](https://assets-docs.dify.ai/2024/12/ab8cae01a590b037017dfe9ea4dbbb8b.png)

### LLM 节点

[LLM 节点](https://docs.dify.ai/guides/workflow/node/llm)是 Chatflow 和 Workflow 的核心组件，利用大语言模型的对话、生成、分类和处理能力，基于使用者输入的指令完成各种任务。

以下是运行时常见的 6 种错误：

1.  **未找到对应变量（VariableNotFoundError）**

    如果 LLM 找不到系统提示词或在上下文中设置的变量，则会出现此错误。应用开发者可以通过替换异常变量来解决此问题。



    ![VariableNotFoundError](https://assets-docs.dify.ai/2024/12/f20c5fbde345144de6183374ab277662.png)
2.  **上下文结构无效（InvalidContextStructureError）**

    LLM 节点内的 [上下文](https://docs.dify.ai/guides/workflow/node/llm#explanation-of-special-variables) 接收到非法数据结构（如 `array[object]`）时会报错。

    > 上下文仅支持字符串（String）数据结构。



    ![InvalidContextStructureError](https://assets-docs.dify.ai/2024/12/f20c5fbde345144de6183374ab277662.png)
3.  **错误的参数类型（InvalidVariableTypeError）**

    系统提示词的类型不为常规的 Prompt 文本或 Jinja 语法格式，则出现此错误。
4.  **模型不存在（ModelNotExistError）**

    每个 LLM 节点都需要配置一个模型，如果未选中模型将出现此错误。
5.  **LLM 需授权（LLMModeRequiredError）**

    LLM 节点所选中的模型未配置 API Key，你可以阅读 [此文档](https://docs.dify.ai/guides/tools/tool-configuration) 授权模型。
6.  **未找到提示词（NoPromptFoundError）**

    LLM 节点的提示词不能为空，否则异常。



    ![NoPromptFoundError](https://assets-docs.dify.ai/2024/12/9882f7a5ee544508ba11b51fb469a911.png)

### HTTP

[HTTP 节点](https://docs.dify.ai/guides/workflow/node/http-request)允许通过发送 HTTP 请求获取数据、触发Webhook、生成图像或下载文件，从而通过可定制的请求与外部服务无缝集成。以下是该节点常见的 5 种错误：

1.  **授权配置错误（AuthorizationConfigError）**

    未配置认证信息（Auth）时出现此报错。
2.  **文件获取错误（FileFetchError）**

    无法获取文件变量时出现此报错。
3.  **无效的 HTTP 请求方法（InvalidHttpMethodError）**

    请求头非以下方法：GET、HEAD、POST、PUT、PATCH 或 DELETE，出现报错。
4.  **响应大小超限（ResponseSizeError）**

    HTTP 返回的响应大小限制为 10MB，如果响应超出限制，出现报错。
5.  **HTTP 响应代码错误（HTTPResponseCodeError）**

    当请求响应返回非 2 开头的代码时（例如 200, 201）将报错。如果开启了异常处理，当返回的状态码为 400、404、500 时将报错，否则不会报错。

### 工具

运行时常见以下 3 种错误：

1.  **工具执行异常（ToolNodeError）**

    工具本身执行的异常报错，例如达到了目标 API 的请求限制。

![](https://assets-docs.dify.ai/2024/12/84af0831b7cb23e64159dfbba80e9b28.jpg)

2.  **工具参数异常（ToolParameterError）**

    所配置的工具节点参数存在异常，传入了不符合工具节点所定义的参数。
3.  **工具文件处理异常（ToolFileError）**

    工具节点未找到所需的文件，出现报错。

{/*
Contributing Section
DO NOT edit this section!
It will be automatically generated by the script.
*/}

---

[编辑此页面](https://github.com/langgenius/dify-docs/edit/main/zh-hans/guides/workflow/error-handling/error-type.mdx) | [提交问题](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)

