Azure Data Factory中for-each活动未逐个传文件反而重复全量传文件问题

核心常见配置错配点 #

• Items 入参绑定逻辑错误
  新手最容易踩的坑是把「整个 Blob 文件夹的全量文件扫描结果」直接作为 For-Each 的循环入参，同时在循环内部的复制活动里又重复配置了一次全文件夹扫描逻辑。这种链路下，For-Each 生成的6轮循环，每轮都会独立触发一次全文件夹扫描，完全不会根据循环上下文定位单文件，最终就会出现“每轮都捞到全部6个文件、累计扫描出24个异常计数”的现象。
  正确链路逻辑：先通过 Get Metadata 活动按规则筛选出当日待处理的6个文件，将输出的单文件数组绑定为 For-Each 的 Items 入参，循环内部的复制活动直接引用当前循环对应的文件路径，不再重复做全文件夹扫描。
• Get Metadata 活动扫描范围配置错误
  检查 Get Metadata 活动的两个默认开关：一是是否开启了「递归扫描子文件夹」，导致把非当日日期目录下的历史同类型文件也纳入了扫描范围；二是是否没有设置文件路径过滤，把Blob容器下所有目录的文件都识别为待处理对象，这也是单轮循环识别到24个文件（6个当日文件*4个历史日期同路径文件）的核心诱因。
  正确配置方式：将Get Metadata的路径直接定位到当日日期分区的文件夹，取消勾选递归扫描选项，确保扫描结果只包含当日需要处理的6个目标文件。
• 循环内复制活动的动态路径拼接错误
  如果循环内部的复制活动，源路径仍然填写为整个文件夹的静态路径，没有引用循环上下文的变量，哪怕For-Each正确生成了6轮循环，每轮活动还是会读取路径下的全量文件，完全无法实现逐文件处理的预期。
  正确的路径参数写法：在复制活动的Blob源路径中，用动态表达式拼接当前循环的单文件路径：@concat(pipeline().parameters.ContainerBasePath, '/', item().name)，确保每轮只定位到循环数组里的对应单文件。
• For-Each 执行规则配置错配
  检查For-Each的两个关键配置：一是是否开启了「顺序执行」开关，如果没有开启，默认并发的循环实例会共享扫描结果，容易出现每轮都拿到全量文件的异常表现；二是批处理计数是否设置过大，并发实例过多时会出现文件识别结果串值的问题。逐文件顺序处理的场景下，需要开启顺序执行开关，将批处理计数设置为1。

快速验证排查步骤 #

逐点校验快速定位问题：

• 点击For-Each活动的Items参数旁的「预览数据」按钮，确认入参数组的长度为6，每个数组元素对应一个独立的目标文件名，不存在嵌套的子数组结构
• 进入单轮循环内的复制活动，点击源路径的「预览数据」，确认单轮只识别到1个目标文件，而非全文件夹的多文件列表
• 排查所有涉及文件扫描的活动，移除冗余的全路径扫描、递归扫描配置，避免重复扫描带来的计数偏移

内容的提问来源于stack exchange，提问作者Maryam-AM