You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Postman Collection Runner如何在数据文件中定义数组测试数据

针对你的API结构,要为myDataArray这个嵌套数组提供多轮测试的数据,主要可以通过JSON格式数据文件或者CSV格式数据文件来实现,具体取决于你使用的测试工具(比如Postman、JMeter、Newman等)。下面是两种方式的详细说明:

1. JSON格式数据文件(最适配JSON API结构)

因为你的API本身是JSON结构,用JSON数据文件可以直接映射嵌套的数组结构,每一条数组元素对应一轮测试的完整请求数据。

比如创建一个test-data.json文件,内容如下:

[
  {
    "myVar01": "第一轮测试值01",
    "myVar02": "第一轮测试值02",
    "myVar03": "第一轮测试值03",
    "myVar04-01": "第一轮嵌套值04-01",
    "myVar04-02": "第一轮嵌套值04-02",
    "myDataArray": [
      {
        "myArrayVar01": "第一轮数组元素1-01",
        "myArrayVar02": "第一轮数组元素1-02",
        "myArrayVar03": "第一轮数组元素1-03",
        "myArrayVar04": "第一轮数组元素1-04",
        "myArrayVar05": "第一轮数组元素1-05"
      },
      {
        "myArrayVar01": "第一轮数组元素2-01",
        "myArrayVar02": "第一轮数组元素2-02",
        "myArrayVar03": "第一轮数组元素2-03",
        "myArrayVar04": "第一轮数组元素2-04",
        "myArrayVar05": "第一轮数组元素2-05"
      }
    ]
  },
  {
    "myVar01": "第二轮测试值01",
    "myVar02": "第二轮测试值02",
    "myVar03": "第二轮测试值03",
    "myVar04-01": "第二轮嵌套值04-01",
    "myVar04-02": "第二轮嵌套值04-02",
    "myDataArray": [
      {
        "myArrayVar01": "第二轮数组元素1-01",
        "myArrayVar02": "第二轮数组元素1-02",
        "myArrayVar03": "第二轮数组元素1-03",
        "myArrayVar04": "第二轮数组元素1-04",
        "myArrayVar05": "第二轮数组元素1-05"
      }
    ]
  }
]
  • 每一个顶级数组元素对应一轮测试,工具会自动将API模板中的{{变量名}}替换为数据文件中对应的字段值。
  • myDataArray可以根据测试需求设置任意长度的子数组,完全匹配API的结构。

2. CSV格式数据文件(适合扁平数据场景)

如果你的测试工具更倾向于使用CSV(比如JMeter、Postman集合运行器),可以通过索引标记来映射嵌套数组的元素,CSV的每一行对应一轮测试。

比如创建一个test-data.csv文件,内容如下:

myVar01,myVar02,myVar03,myVar04-01,myVar04-02,myDataArray[0].myArrayVar01,myDataArray[0].myArrayVar02,myDataArray[1].myArrayVar01,myDataArray[1].myArrayVar02
第一轮测试值01,第一轮测试值02,第一轮测试值03,第一轮嵌套值04-01,第一轮嵌套值04-02,第一轮数组元素1-01,第一轮数组元素1-02,第一轮数组元素2-01,第一轮数组元素2-02
第二轮测试值01,第二轮测试值02,第二轮测试值03,第二轮嵌套值04-01,第二轮嵌套值04-02,第二轮数组元素1-01,第二轮数组元素1-02,,
  • 用[索引]标记数组中的元素位置,比如myDataArray[0]表示数组的第一个元素,myDataArray[1]表示第二个元素。
  • 空值(比如第二行最后两个空字段)表示该轮测试中对应的数组元素不存在,工具会自动生成对应长度的数组结构。

关键注意事项

  • 确保数据文件中的字段名和API模板中的变量名完全一致,比如API中的{{myVar01}}对应数据文件里的myVar01,嵌套数组的myArrayVar01对应数据文件里的myDataArray[0].myArrayVar01(CSV)或JSON子对象的myArrayVar01。
  • 针对API里的{{&lt;myVar03&gt;}},这是转义后的{{<myVar03>}},确认变量名实际为myVar03后,直接在数据文件中使用myVar03作为键名即可。
  • 不同测试工具对数据文件的解析逻辑略有差异,但核心思路都是为每轮测试提供完整的myDataArray结构数据,适配API的嵌套要求。

内容的提问来源于stack exchange,提问作者user2776069

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.06 09:07:38