如何在Newman中为同一集合传入多个iteration-data JSON文件？

方案1：矩阵中动态拼接多-d参数 #

利用GitHub Actions的矩阵变量和字符串拼接，直接生成包含多个-d参数的Newman命令，避免每个数据文件单独启动一次测试。

示例配置：

jobs:
  newman-test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        # 定义要测试的集合和对应的多数据文件组
        test-group:
          - collection: "View.collection.json"
            data-files: ["data1.json", "data2.json", "data3.json"]
    steps:
      - uses: actions/checkout@v4
      - name: Install Newman
        run: npm install -g newman
      - name: Run Newman with multiple data files
        run: |
          # 将data-files数组转成多个-d 参数
          DATA_ARGS=$(printf " -d %s" "${{ join(matrix.test-group.data-files, ' -d ') }}")
          newman run ${{ matrix.test-group.collection }} $DATA_ARGS

核心是用join函数把数组里的文件名拼接成-d data1.json -d data2.json的格式，和本地命令行多次加-d的效果完全一致。

方案2：预先合并迭代数据文件 #

如果数据文件结构一致，可以先把多个JSON数据文件合并成一个数组格式的文件，让Newman一次加载所有迭代数据。

比如单个数据文件是对象格式：

{"input": "foo", "expected": "bar"}

用Shell命令合并成数组文件：

jq -s '.' data1.json data2.json data3.json > combined-data.json

GitHub Actions配置示例：

jobs:
  newman-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install dependencies
        run: |
          npm install -g newman
          sudo apt-get install jq
      - name: Combine data files
        run: jq -s '.' data1.json data2.json data3.json > combined-data.json
      - name: Run Newman with combined data
        run: newman run View.collection.json -d combined-data.json

注意：若原数据文件已是数组格式，需调整jq命令避免嵌套数组。

方案3：用自定义脚本生成执行命令 #

如果需要更灵活的逻辑（比如根据分支动态选数据文件），可以写简单的Shell脚本处理参数：

新建run-newman.sh：

#!/bin/bash
COLLECTION=$1
shift
DATA_ARGS=""
for FILE in "$@"; do
  DATA_ARGS="$DATA_ARGS -d $FILE"
done
newman run $COLLECTION $DATA_ARGS

GitHub Actions调用示例：

jobs:
  newman-test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        collection: ["View.collection.json"]
        data-files: [["data1.json", "data2.json"]]
    steps:
      - uses: actions/checkout@v4
      - name: Install Newman
        run: npm install -g newman
      - name: Make script executable
        run: chmod +x run-newman.sh
      - name: Run Newman test
        run: ./run-newman.sh ${{ matrix.collection }} ${{ join(matrix.data-files, ' ') }}

为什么直接传数组会报错？ #

Newman的官方GitHub Action（若使用postmanlabs/newman-action）不支持接收数组作为iteration-data参数，它会把数组当成单个字符串解析，导致模板解析错误。而直接用命令行调用Newman时，多次使用-d是官方支持的多数据文件传入方式，上述方案都是围绕还原命令行的多-d参数逻辑实现的。

内容的提问来源于stack exchange，提问作者Dev Raj