Loop boolean break condition renders string “false” as True

问题场景

用户在 Dify 中创建 Chatflow，添加 Loop 节点并配置了布尔类型的循环变量 is_complete（初始值为 false）。在循环条件中设置 is_complete is True 作为 break 条件后，工作流运行时循环在开始执行任何迭代之前就异常退出。

报错原文

Loop boolean break condition renders string "false" as True

原因分析

可能原因：问题由两个独立缺陷叠加导致。

1. 初始化值类型错误：addBreakCondition 函数将布尔变量的初始值设为字符串 'false'，而非布尔值 false。

2. 字符串 truthy 判断问题：BoolValue 组件在接收 condition.value as boolean 时，由于存储值实际为字符串 "false"，JavaScript 的 truthiness 规则会将非空字符串视为真值，导致 UI 错误地高亮 True 选项。

3. 变量切换重置逻辑不完善：handleVarChange 在用户切换变量时无条件将值重置为空字符串 ''，没有考虑布尔变量应默认初始化为 false 的情况。

环境排查

• 确认 Dify 版本是否为 1.16.0-rc1 或更新的 main 分支版本
• 检查工作流 DSL 中 Loop 节点 break 条件的 value 字段是否为字符串 "false" 而非布尔值 false
• 确认前端构建资源是否包含 use-config.helpers.ts 和 bool-value.tsx 的最新逻辑
• 验证浏览器开发者工具 Console 中是否有类型相关的警告信息

解决步骤

1. 定位前端源码文件 web/app/components/workflow/nodes/loop/use-config.helpers.ts，在 addBreakCondition 函数中找到初始化代码。
2. 将布尔类型的初始化值从字符串改为布尔值：
   value: variable.type === VarType.boolean ? 'false' : '' 修改为 value: variable.type === VarType.boolean ? false : ''
3. 打开 web/app/components/workflow/nodes/loop/components/condition-list/condition-item.tsx，在 handleVarChange 函数中同步修改重置逻辑：
   draft.value = varItem.type === VarType.boolean ? false : ''
4. 对于旧工作流的兼容处理：在 BoolValue 组件（web/app/components/workflow/panel/chat-variable-panel/components/bool-value.tsx）中增加字符串到布尔值的规范化转换，再传递给 selected 属性。
5. 重新构建前端资源并重启服务。
6. 在测试环境中验证：新建 Loop 节点 + 布尔变量 + break 条件的完整流程。

验证方法

创建包含 Loop 节点的测试 Chatflow：配置布尔变量初始值为 false，设置 break 条件为 is_complete is True。运行工作流并确认：

• 工作流 DSL 中存储的值为布尔值 false 而非字符串 "false"
• UI 界面中 break 条件默认显示为 False（不选中 True）
• 循环正常执行至少一次迭代，不会在首次迭代前意外退出

参考来源

langgenius/dify #41185

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。