Dify 工作流失败，不要一开始就怀疑模型或重搭整条链路。大多数问题出在节点输入、变量映射、条件分支和上游返回格式。排查时按一次运行记录往下追，比凭感觉改节点更有效。

先看失败发生在哪个节点

把一次失败运行打开，先定位红色或异常节点，再看它收到的输入和实际输出。很多错误会在上游埋下，比如检索节点没拿到文档、LLM 节点输出了非 JSON、条件节点拿到空变量。Dify 的 日志文档适合用来追踪应用运行记录，关键是不要只看最后一个报错。

变量名要逐个核对

工作流里最常见的低级问题，是变量路径写错或节点改名后没有同步。排查时把关键变量列出来：用户输入是什么、知识库返回什么、模型节点输出什么、后续节点读取哪个字段。只要某一步值为空，后面的节点再怎么改提示词也没用。

模型节点要限制输出形状

如果下游需要结构化数据，就不要让模型自由发挥。提示词里写清字段、类型和失败时返回什么；必要时加一个校验节点，把不合格输出拦住。比起让整个工作流随机失败，提前发现格式不对更容易维护。

什么时候才需要重构工作流

如果失败只发生在一个变量或一个节点，不要重搭。只有当一条工作流同时承担检索、分类、生成、审核、外部调用和通知，且每一步都互相耦合时，才考虑拆成多个小工作流。Dify 的优势是可编排，但可编排不等于把所有逻辑都塞进一张图。