Dify工作流默认值机制仅对null、undefined及空字符串("")触发回退,"0"、"false"、" "等非空字符串不触发;默认值须为合法JSON,支持静态配置或动态函数如{{now()}},且需按类型选安全值:字符串用""、数字用0、布尔用true/false、对象/数组用{}或[]。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当Dify工作流因上游节点未输出、用户未传参或表达式求值为空而出现null/undefined/空字符串时,后续节点极易报错中断——必须用默认值填充来兜底。
识别哪些值会被默认值机制自动覆盖
系统只对以下三类“空”触发default回退:值为null、undefined,或字符串类型且长度为0(即"")。
注意:【"0"、"false"、" "(含空格的字符串)均不被视为“空”,不会触发默认值】。比如变量user_age若被赋值为字符串"0",即使它在业务逻辑中代表“未填写”,Dify也不会回退到default: 18。
这一步操作起来很简单,直接在调试面板里看变量实际值类型和内容就能判断。
静态默认值设置(最常用)
进入工作流编辑器 → 点击左侧「变量」面板 → 新增变量或点击已有变量 → 在「默认值」输入框中填写合法JSON值。
字符串填"guest",数字填3,布尔值填true,对象填{"status":"pending"}——所有内容必须符合JSON语法,否则保存失败。
这一步不能输JavaScript表达式或双花括号模板,否则会报错提示“无效的JSON格式”。
动态默认值设置(基于上下文计算)
方法一:使用value字段配合default实现条件 fallback
在变量配置中同时声明value与default:
{ "name": "user_email", "value": "{{input.email}}", "default": "anonymous@domain.com" }
系统先尝试解析{{input.email}},若结果为null/undefined/"",才启用default。
方法二:用表达式函数生成默认值
支持内置函数如{{ now() }}、{{ uuid() }}、{{ env('REGION') }}等,直接写进default字段即可:
"default": "{{ now('YYYY-MM-DD') }}" → 每次流程启动都生成当天日期字符串。
【env()函数读取的是部署环境变量,不是工作流变量;未定义的环境变量返回null,会继续fallback到default】
按数据类型选择安全默认值
第一步:确认变量类型
第二步:对照类型选默认值
① 字符串(string)→ 推荐""(空字符串),慎用"N/A"等占位符,避免下游正则或长度校验失败。
② 数字(number/integer)→ 必须填纯数字,如0或30;填"0"会被当成字符串导致算术节点报错。
③ 布尔(boolean)→ 显式写true或false,不要写"true"或1。
④ 对象/数组 → 只能填合法JSON结构,如{}或[],不可留空或填null。











