在 Dify 工作流中，使用变量聚合器节点可以将条件分支（IF/ELSE）或并行路径产生的不同输出合并为同一个变量，供下游节点统一调用。适用场景包括问题分类后的多路检索合并、多分支状态汇总，风险边界在于各分支输出变量类型必须一致，否则会导致下游节点执行错误。
先说结论：变量聚合器是解决多分支工作流数据孤岛的关键节点，能将不同路径的输出映射为统一变量。
- 适合：IF/ELSE 条件分支后需要统一处理结果的场景
- 先看：各分支输出的变量类型是否一致（如均为字符串或 JSON）
- 建议：在聚合节点后连接日志或调试节点，验证变量值是否正确汇入
快速处理思路
处理多路输入的核心逻辑是“定义统一出口，映射分支来源”。不需要为每个分支单独编写下游节点，只需在分支汇合处添加变量聚合器。配置时重点检查选择器（selector）路径，确保能正确抓取到上游分支输出的变量值。若分支逻辑复杂，建议先简化为两路测试，验证通后再扩展多路。
为什么会这样
变量聚合器的核心作用是打破不同分支间的变量隔离，实现状态统一管理。在 Dify 工作流中，不同分支（如 IF 节点的 True/False 路径）产生的变量默认是隔离的，下游节点无法直接引用未执行分支的变量。通过变量聚合器，可以将多个分支下相同作用的变量映射为一个输出变量，避免下游节点重复定义。这解决了数据孤岛问题，简化了跨节点的数据传递逻辑。
分步处理
第一步：在工作流编辑器中，于条件分支（IF/ELSE）或并行节点后的汇合处，添加“变量聚合器”节点。第二步：配置聚合器的输出变量结构，定义下游需要引用的变量名和数据类型。第三步：为每个输出变量设置选择器（selector），分别指向不同分支上游节点对应的输出变量。第四步：连接下游节点，使用聚合器输出的统一变量名进行引用，不再区分来源分支。第五步：保存工作流，进入调试模式，分别触发不同分支路径，观察聚合器输出是否符合预期。
怎么验证是否生效
验证方法是运行工作流并检查执行日志。在调试面板中，分别输入触发不同分支条件的数据，查看变量聚合器节点的输出详情。确认无论走哪个分支，聚合器输出的变量名保持一致，且值内容正确对应上游节点的计算结果。若下游节点能正常读取该变量且无类型报错，则配置生效。
常见坑
第一个坑是变量类型不匹配，若分支 A 输出字符串，分支 B 输出 JSON，聚合后下游可能解析失败，需确保各分支输出类型一致。第二个坑是选择器路径错误，若上游节点 ID 变更或变量名拼写错误，聚合器将无法抓取到值，导致下游收到空值。第三个坑是分支覆盖不全，若存在未连接到聚合器的分支路径，该路径执行时下游将获取不到聚合变量，需确保所有逻辑路径均汇入聚合器。
常见问题
必须使用变量聚合器吗？
不是必须，但能显著简化配置。若下游节点不多，可以为每个分支单独连接下游节点，但会增加维护成本。
各分支输出类型不同怎么办？
需要在分支内先进行类型转换，确保汇入聚合器前的数据类型一致，或使用代码节点统一格式化后再聚合。
聚合器会影响执行速度吗？
公开资料中没有看到可靠的量化数据，但作为逻辑映射节点，其本身计算开销极小，主要耗时仍在上游业务节点。
参考来源
1. Dify 工作流中的变量聚合节点
2. Awesome-Dify-Workflow:变量聚合器高级用法
3. Dify 工作流实战：从零构建企业级 AI 应用的高效配置指南