Dify Failed to invoke tool: Aborted: Maximum execution steps exceeded: 501 exceeds 500

佚名 2026-07-22 08:58:00

报错分析

这个错误 Failed to invoke tool : Aborted: Maximum execution steps exceeded: 501 > 500 是 Dify 工作流引擎的执行步数限制机制触发的。

工作流执行达到了最大步数限制（500 步），在第 501 步时被强制中止。

限制定义位置：init.py 中的 WorkflowConfig 类：
WORKFLOW_MAX_EXECUTION_STEPS: PositiveInt = 500# 默认值
执行层：graphon 包的 ExecutionLimitsLayer 作为中间件挂载到 GraphEngine 上（workflow_entry.py）。
计数逻辑：每触发一个 NodeRunStartedEvent（即每个节点开始执行），step_count 就加 1。然后在节点执行完成（成功或失败）时检查：
def _reached_step_limitation(self) -> bool:return self.step_count > self.max_steps# 501 > 500
中止流程：超过限制后，通过 AbortCommand 命令通道通知引擎停止，然后引擎发出 GraphRunAbortedEvent，最终被 WorkflowAppRunner 转换为工作流失败事件。

你的工作流包含太多的执行步骤，典型情况包括：

方案	方法
增加限制	设置环境变量 `WORKFLOW_MAX_EXECUTION_STEPS=1000`（或更大值）
优化工作流	减少迭代节点循环次数，或优化 Agent 节点的 prompt 让 LLM 减少不必要的工具调用
设置 .env	在 envs 或 `api/.env` 中添加 `WORKFLOW_MAX_EXECUTION_STEPS=1000` 后重启