迭代节点仅接受JSON Array类型输入，字符串等需先转为数组；可用代码节点return {"items": str.split(",")}或参数提取节点配合Schema/正则实现安全转换。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认输入数据已为合法Array格式
迭代节点不会自动将字符串、对象或空值转为数组，若上游节点输出的是逗号分隔的字符串（如"苹果,香蕉,橙子"），直接连入迭代节点会触发报错并中断流程。
进入上游节点（如代码节点或模板节点），在返回值中显式构造 JSON 数组：使用 Python 语法 【return {"items": input_str.split(",") }】 或 Jinja2 模板语法 {{ input_str | split(",") }}，确保输出字段值是 ["苹果","香蕉","橙子"] 这样的原生数组。
这一步不可跳过——Dify 迭代节点只认 JSON Array 类型，其他类型均被判定为“非可迭代输入”而拒绝执行。
用参数提取节点安全转换非结构化文本为Array
方法一：从大模型输出中抽提结构化列表
在 LLM 节点后接「参数提取」节点，配置参数名为 sections，类型选 Array[Object] 或 Array[String]（根据实际内容选），在示例文本框中粘贴一段含编号章节的模型输出（如“1. 引言；2. 方法；3. 结果”），点击「生成 Schema」让 Dify 自动推断结构。
方法二：对纯文本做正则切分
在「参数提取」节点的高级模式中启用正则提取，填写表达式 (?，匹配带编号的段落内容；勾选「输出为数组」，即可把一段长文本按小节精准切分为数组元素。
注意：正则模式下若首行无编号，第一段可能被遗漏，建议在 LLM 提示词中强制要求“每段以‘1. ’‘2. ’开头”。
嵌套循环处理二维数据（如用户→订单→商品）
第一步：外层循环遍历用户列表，配置 input_path 为 $.users，变量名设为 user_item；
第二步：在该迭代节点内部插入第二个迭代节点，其 input_path 填写 $.user_item.orders，变量名设为 order_item；
第三步：再在内层迭代中嵌入第三个迭代节点，input_path 设为 $.order_item.items，变量名用 product_item；
第四步：在最内层放置 HTTP 调用节点，URL 中引用 {{product_item.sku}}，请求体中传 "customer_id":"{{user_item.id}}","order_id":"{{order_item.id}}"。
这样三层变量命名完全隔离，避免 item 冲突导致取值错误——【嵌套超过三层时，必须手动重命名每一层变量，否则内层会覆盖外层同名变量】。
控制迭代并发度与失败策略
在迭代节点配置面板中，找到「执行模式」选项：
选「串行」：适合需强顺序依赖的操作，比如调用有状态 API 或写入单条数据库记录；
选「并行（最大5个）」：默认开启，适用于独立推理任务，能将 100 条数据的处理时间从 100 秒压至约 20 秒；
在「错误处理」中，必须明确选择「跳过失败项」或「中断整个迭代」——【若不设置，任何一项出错都会导致整个迭代节点失败并返回空数组】。
用代码节点聚合迭代结果并过滤无效项
迭代节点输出始终是数组，但其中可能混入 null、空字符串或结构异常对象。在迭代节点后接一个「代码节点」，语言选 Python，输入变量填 iteration_output，代码写：
valid_items = [x for x in iteration_output if x and isinstance(x, dict) and x.get("text")]<br>return {"cleaned": valid_items}
这一步直接筛掉空值和缺失关键字段的项，输出干净可用的数组供后续节点使用。
