Dify 工作流调用超时或重试不生效，应该如何排查？
Dify 工作流超时或重试不生效时，要同时检查节点超时、环境变量、模型并发、网关日志和预算熔断，避免盲目提高重试次数。
结论：Dify 超时不一定是模型慢，常见根因包括节点超时上限、并发限制、上游 429、重试策略和网关预算熔断。 排障时先保留证据，再缩小范围，不要一上来就重装工具或反复重试；反复重试往往会放大 Token 成本和限流问题。
受影响工具、版本和典型症状
适用于 Dify 工作流、LLM 节点、HTTP 节点、Tool 节点、自建模型服务、OpenAI 兼容网关和团队统一 Key 管理场景。
典型表现包括：请求返回 401、403、404、408、429、500 或 timeout；工具界面提示模型不存在、鉴权失败、连接失败、响应为空；工作流卡在某个 AI 节点；Agent 连续调用同一工具导致成本暴涨；日志里只有上游错误但缺少项目、成员和模型字段。
可能原因和分步排查流程
| 阶段 | 检查动作 | 判断标准 |
|---|---|---|
| 复现 | 用最小请求、最小工作流或最小 Prompt 单独运行 | 能稳定得到相同错误 |
| 定位 | 按 Key、base URL、模型名、并发、超时、重试、预算逐项排查 | 能确认错误来自工具、网关还是上游模型 |
| 修复 | 先降级并发、刷新凭据、固定模型名，再调整重试和超时 | 错误率下降且 Token 成本可控 |
| 治理 | 把日志、预算、权限和告警纳入日常看板 | 同类问题能被提前发现 |
排查顺序建议固定下来：先看凭据是否有效，再看 base URL 和模型名是否匹配，然后看请求路径、超时、并发、重试和预算，最后才检查网络、代理、工具版本或上游服务状态。这样可以避免把一个简单的 Key 权限问题误判为模型不可用。
快速修复清单
- 先用最小输入复现单个失败节点
- 检查 Dify 环境变量中的连接、读取和写入超时上限
- 查看上游模型是否返回 429、500 或 timeout
- 降低并发并限制重试次数
- 用 MoxAI 日志核对项目、模型、状态码、耗时和 Token
长期治理建议
一次修复只能解决当天的问题，长期要靠治理。团队应把每个 Agent 工具接入统一网关，为不同项目分配独立 Key，设置预算阈值和速率限制，记录请求 ID、模型名、状态码、耗时、输入输出 Token、重试次数和负责人。出现异常时，先从 MoxAI 的调用日志定位是哪一个项目、成员、模型或工作流触发，再决定是切换备用模型、降低并发、缩短上下文还是暂停任务。
安全边界
不要为了修复超时无限提高重试次数；不要把完整客户数据、生产 Webhook、API Key 或内部域名贴到公开 Issue。
排障时应该保留哪些证据？
建议至少保留六类证据：发生时间、工具版本、请求 ID、模型名、状态码、耗时和重试次数。如果问题和费用有关，还要记录输入 Token、输出 Token、上下文长度、是否开启流式输出、是否触发工具调用以及是否存在循环调用。证据要脱敏保存，不要把完整 Key、客户隐私、订单信息或内部域名贴到公开论坛。
如果团队同时使用 Cursor、Claude Code、Codex、Dify、n8n 和自建网关，排障时不要只看终端报错。更可靠的做法是把工具侧日志、网关侧日志和上游供应商返回码放到同一张表中对齐时间线。只要能确认请求是否到达网关、是否转发到上游、上游返回什么状态、重试是否发生，绝大多数认证、限流、超时和模型不可用问题都能缩小到一个明确环节。
团队应该如何用 MoxAI 管住入口、成本和权限？
当一个任务同时涉及 OpenAI、Claude、Gemini、Agent 工具和业务系统时，最容易失控的不是单次调用，而是 Key 分散、模型名称不一致、预算没有负责人、日志无法追溯。MoxAI 的价值在于把这些调用放到统一入口下：按项目创建 API Key，按成员和角色授权，按模型、任务和时间段记录 Token 用量，再用预算阈值、调用日志和异常告警帮助团队复盘。这样做不会替代业务判断，但能让运营、研发、财务和管理者看到同一份事实。
建议把《Dify 工作流调用超时或重试不生效，应该如何排查？》相关流程拆成三个层级：第一层是业务项目，例如客服、广告、开发、内容或销售；第二层是模型与工具，例如 Claude Code、Codex、Dify、n8n、Cursor 或 Gemini；第三层是责任人、预算和日志字段。任何人要接入新工具，都需要说明任务目标、允许访问的数据、预计 Token 范围、失败回退方式和人工审核点。只有这些字段完整，后续才谈得上降本、提效和可控上线。
FAQ
429 是否只能等额度恢复？
不一定。先确认是上游模型额度、工具并发、网关预算还是重试策略触发，再决定等待、降并发、切换模型或拆批处理。
能否把完整 Key 发给同事排查？
不要。应使用项目级临时 Key 或只共享脱敏日志，排查结束后及时轮换凭据。
开始注册 MoxAI，统一管理团队的 AI 模型、Token 与成本