---
title: 调试节点
---

Workflow / Chatflow 类型应用通常包含多个节点，每个节点互有关联。若要确保应用整体运行正常，需要确认每个节点的输入输出符合预期。调试节点功能可以帮助开发者检测应用是否按照设计预期提供服务，提前发现并解决潜在问题，避免在生产环境中出现错误。

你可以通过以下两种模式调试节点。

## 单步调试

单步调试允许你对工作流内的特定节点进行独立测试，无需执行整个工作流。它可以帮助开发者在应用内添加新节点时验证其功能、排查特定节点的错误以及测试节点对不同输入的响应。

### 操作步骤

1. 在工作流编辑界面选择需要调试的节点
2. 点击节点右上角的 **run step** 按钮
3. 在弹出的调试面板中填写该节点的输入变量
4. 点击执行按钮触发节点运行
5. 查看节点的输出结果及运行状态

例如，在工作流内添加了一个 HTTP 节点，为验证该节点能否正确获取并处理 API 响应，你可以使用单步调试功能模拟节点的实际工作状态，而不会影响下游节点。

![](https://assets-docs.dify.ai/2025/04/376c9de6f92cb7a5f97a6661c5e0e9eb.png)

调试完成后，你可以看到当前节点的运行状态、输入/输出、元数据信息。如遇报错，可通过报错信息快速排查错误，避免节点异常导致的应用整体运行失败。

<Warning>
    回答、结束节点不支持单步调试。
</Warning>

## 逐步执行

逐步执行适用于测试多个相互依赖的节点组合，特别是当节点的输入依赖于上游节点的输出时。与单步调试不同，逐步执行会从起始节点开始，按照工作流路径依次执行到指定节点。

### 操作步骤

1. 在工作流编辑界面选择需要作为终点的目标节点
2. 点击该节点右上角的 **run to** 按钮激活逐步执行功能
3. 系统将从起始节点开始，按照工作流路径依次执行至目标节点
4. 执行完成后，可查看每个节点的运行状态和输出结果

假设你有一个包含数据获取(A节点)→数据处理(B节点)→结果展示(C节点)的工作流，B节点的功能完全依赖于A节点的输出。使用逐步执行功能，你可以选择B节点并点击"run to"，系统将先执行A节点再执行B节点，让你能够验证两个节点之间的数据传递是否正常。

逐步执行过程中，你可以观察局部工作流的运行情况，基于结果及时调整节点的配置、数据流向和处理逻辑，确保工作流的效率和准确性。

![](https://assets-docs.dify.ai/2025/04/5bb7e8c6e2f0af38d272d2f4bfa3e90a.png)

<Warning>
    对于问题分类节点、条件节点等存在多分支处理情况，不支持逐步执行功能。
</Warning>

## 查看节点运行记录

每个节点运行完成后都会生成操作日志，你可以点击节点详情页中的 Last run 查看运行历史。

![](https://assets-docs.dify.ai/2025/04/5ee92e6406979f5101d21865f95a86e5.png)

如需查看应用整体的运行历史，详细说明请参考[运行历史](/zh-hans/guides/workflow/debug-and-preview/history-and-logs)。

{/*
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/debug-and-preview/debug-node.mdx) | [提交问题](https://github.com/langgenius/dify-docs/issues/new?template=docs.yml)

