为dify agent配置错误出口连线、节点级重试策略、结构化异常映射及部署前验证，可实现知识库503错误时自动回退至备用路径，并对超时和5xx错误智能重试，确保服务高可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
为Dify Agent节点配置错误出口连线
当用户提问触发智能客服工作流时，若知识库检索节点因向量数据库503错误中断，系统必须立刻切换到备用路径，否则用户将卡在“正在处理”界面。这一步是整个回退机制的物理基础。
在Dify可视化画布中，选中目标节点（如“RAG检索”），将鼠标悬停在其右下角出现的红色闪电图标上→按住左键拖出一条带叉号的虚线→松开后指向你预先准备好的回退节点（例如“静态提示生成器”）。
【必须确保回退节点已存在且配置完成，否则连线无法建立】
这条连线不是装饰——它会被编排引擎识别为error_handler.fallback_node字段，运行时一旦捕获retrieval.service_unavailable类异常，立即跳转执行，不经过任何条件判断。
设置节点级重试策略
网络抖动导致的HTTP请求超时，适合用重试兜底；而参数校验失败（400）再重试毫无意义。Dify允许你为每个节点单独控制重试行为，避免全局策略误伤。
方法一：在节点右侧配置面板中展开“高级设置”→勾选“启用重试”→输入最大重试次数（建议填3）→设置初始延迟（推荐1秒）→开启“指数退避”开关。
方法二：直接编辑节点JSON配置，在config对象同级添加retry_policy块：
{ "retry_policy": { "max_retries": 3, "initial_delay": 1, "backoff_factor": 2, "max_delay": 10 }, "retry_on": ["timeout", "server_error"] }
注意：这个配置只对5xx和超时生效，400/401类错误不会触发重试——平台已内置语义路由，无需手动过滤。
定义结构化异常类型并绑定处理逻辑
第一步：进入Dify控制台 → 点击左侧“设置” → 选择“异常映射规则”。这里是你统一管理错误语义的地方。
第二步：点击“新增规则”，填写三栏内容：原始错误模式（支持正则，如.*503.*）、映射后的标准类型（填retrieval.service_unavailable）、是否启用（打钩）。
第三步：回到工作流画布，右键点击任意节点→选择“编辑错误处理”→在弹窗中找到“触发条件”下拉框→选择你刚定义的retrieval.service_unavailable→为其指定重试策略或回退节点。
这一步做完，所有匹配503响应的HTTP节点都会自动套用同一套容错逻辑，不用逐个配置。如果私有模型返回{"code":"DB_UNAVAILABLE"}，也只需在这里加一条正则规则，就能纳入整个体系。
部署前验证回退路径是否生效
在Dify开发环境中启动调试模式，手动触发一个必然失败的操作：比如把RAG检索节点的API地址临时改成http://invalid-host:9999。
观察日志面板，确认出现类似“Node 'rag_search' failed with error type: retrieval.connection_refused”的记录。
检查输出结果是否来自你配置的回退节点，而不是报错中断——只要看到预期的降级响应（如“当前查询繁忙，请稍后再试”），说明回退路径已激活。
