Azure Data Factory数组读取异常及foreach loop入参配置问题

前置校验：先定位数组的准确输出路径 #

绝大多数无法读取数组值的异常，都是因为直接引用了活动的根输出节点，没有找对阵列实际所在的层级：

• 先触发一次管道调试，运行产生行输出的上游活动（Lookup、Get Metadata、脚本活动、Filter活动等），运行完成后点开活动的「输出」面板，逐层展开找到目标数组所在的字段位置。

常见活动的默认数组位置参考：

• 未勾选「仅返回首行」的Lookup活动：查询结果数组存放在value字段下
• 执行SQL的脚本活动：第一个结果集的行数组存放在resultSets[0].rows字段下
• Filter过滤活动：过滤完成的结果数组存放在Value字段下

• 注意：如果Lookup活动勾选了「仅返回首行」，输出的是单个对象而非数组，必须取消该勾选才能输出可遍历的数组结构。

ForEach输入项的正确配置方式 #

• 打开ForEach活动的「设置」标签页，找到「项」配置框，不要直接使用系统自动关联的默认活动输出值，手动输入匹配你上游数组路径的表达式。
• 高频场景的可用表达式参考：
  • Lookup全量结果集作为输入：@activity('你的Lookup活动自定义名称').output.value
  • 脚本活动第一结果集行数组作为输入：@activity('你的脚本活动自定义名称').output.resultSets[0].rows
  • Filter活动过滤结果作为输入：@activity('你的Filter活动自定义名称').output.Value
  • 提前存入数组类型管道变量的集合作为输入：@variables('你的数组变量名称')
    核心要求：传入「项」字段的内容必须是标准数组类型，不能是包裹在其他结构里的属性，也不能是单条记录对象，否则会触发类型不匹配、无法读取数组值的异常。

常见异常排查点 #

• 字符串格式数组转换：如果上游返回的数组是JSON字符串格式（比如REST接口返回的序列化数组文本），不能直接传入ForEach，需要先用json()函数转成标准数组结构，示例：@json(activity('REST请求活动').output.ResponseContent).dataList
• 空数组兼容：如果上游查询可能返回空结果，建议在ForEach前增加If条件活动，用@empty(你的数组表达式)判断数组是否为空，空结果时直接跳过循环，避免空值遍历报错。
• 循环内元素读取：ForEach遍历数组时，内部活动读取当前遍历项的属性直接用@item().属性名即可，比如遍历行对象读id字段就写@item().id，不需要额外拼接上游活动的输出路径。
• 并发配置校验：数组元素为复杂对象时，ForEach的并发度不要设置超过50（默认值20即可），过高并发容易出现元素读取截断、遍历不全的问题。

内容的提问来源于stack exchange，提问作者Being Real