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

报错分析

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

根本原因

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

底层机制

1. 限制定义位置 ：init .py 中的 WorkflowConfig 类：

   WORKFLOW_MAX_EXECUTION_STEPS: PositiveInt = 500  # 默认值

2. 执行层 ：graphon 包的 ExecutionLimitsLayer 作为中间件挂载到 GraphEngine 上（workflow_entry.py）。

3. 计数逻辑 ：每触发一个 NodeRunStartedEvent（即每个节点开始执行 ），step_count 就加 1。然后在节点执行完成（成功或失败）时检查：

   def _reached_step_limitation(self) -> bool:
       return self.step_count > self.max_steps  # 501 > 500

4. 中止流程 ：超过限制后，通过 AbortCommand 命令通道通知引擎停止，然后引擎发出 GraphRunAbortedEvent，最终被 WorkflowAppRunner 转换为工作流失败事件。

常见触发场景

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

• 迭代/循环节点 循环次数过多（例如处理了大量数据批次）
• Agent 节点 反复调用工具，形成了很长的思考-行动链条
• 多层嵌套的工作流调用，每层调用都计入步数
• 工作流设计不合理，存在不必要的重复执行

如何解决

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

注意：单纯增大限制只是临时缓解，如果工作流存在死循环或低效调用，仍然会超限。建议先检查工作流设计是否合理。