当前位置：首页 > news >正文

HttpRunner-8-数据驱动-httprunner-8

news 2026/3/27 4:18:22

数据驱动概览

为什么要用数据驱动

举个简单例子，当我们在测试一个输入框的功能时，可能需要输入不同的参数，此时，我们不需要设计多个用例，而只需要将输入值参数化，将不同的参数作为一个列表通过数据驱动的方式进行加载即可。

httprunner 的数据驱动

通过上篇文章，我们已经知道 httprunner 的数据驱动需要在 testsuite 中使用关键字 parameters 来定义。

定义数据源的三种方式

在 testsuite 的 yaml/json 文件中直接定义。
通过内置的 parameterize 函数引用外部 csv 文件，适用大数据场景。
调用 debugtalk.py 定义的函数（动态）生成参数列表，此方式最灵活。

定义参数的两种方式

独立参数定义

config:name: testcase descriptiontestcases:create user:testcase: demo-quickstart-6.ymlparameters:user_id: [1001, 1002, 1003, 1004]

进行该配置后，测试用例在运行时就会对 user_id 实现数据驱动，即分别使用 [1001, 1002, 1003, 1004] 四个值运行测试用例。测试用例总共会运行 4 次，并且每次运行时都采用不同的 user_id。

多个具有关联性的参数定义

config:name: "demo"testcases:testcase1_name:testcase: /path/to/testcase1parameters:username-password:- ["user1", "111111"]- ["user2", "222222"]- ["user3", "333333"]

进行该配置后，测试用例在运行时就会对 username 和 password 实现数据驱动，即分别使用 {"username": "user1", "password": "111111"}、{"username": "user2", "password": "222222"}、{"username": "user3", "password": "333333"} 运行 3 次测试，并且保证参数值总是成对使用。

通过以上内容，我们可以知道，在 HttpRunner 的数据驱动中，我们有 6 种方式进行实现。即：

三种数据源*两种参数定义方式

编号	驱动模式
1	独立参数 & 直接指定参数列表
2	关联参数 & 直接指定参数列表
3	独立参数 & 引用 CSV 文件
4	关联参数 & 引用 CSV 文件
5	独立参数 & 引用自定义函数
6	关联参数 & 引用自定义函数

数据驱动实例

在上面我们已经介绍了 6 中驱动模式，而且也学习了直接在 yml 文件中定义参数的两种场景，那怎么使用 CSV 文件实行数据驱动呢？

独立参数 & 引用 CSV 文件

当我们需要对 user_id(1000 个)进行数据驱动时，首先，需要准备 user_id.csv 文件，文件内容如下：

user_id
1001
1002
...
1999
2000

然后，我们在 testsuite 中就可以通过内置的 parameterize（可简写为 P）函数引用 CSV 文件：

假设 user_id.csv 在项目根目录的 data 目录下

config:name: "demo"testcases:testcase1_name:testcase: /path/to/testcase1parameters:user_id: ${P(data/user_id.csv)}

即 P 函数的参数（CSV 文件路径）是相对于项目根目录的相对路径。当然，这里也可以使用 CSV 文件在系统中的绝对路径，不过这样的话在项目路径变动时就会出现问题，因此推荐使用相对路径的形式。

关联参数 & 引用 CSV 文件

当我们需要对 username-password(1000 个)进行数据驱动时，首先，需要准备 account.csv 文件，文件内容如下：

username,password
test1,111111
test2,222222
test3,333333
...
test1000,999999

然后，我们在 testsuite 中就可以通过内置的 parameterize（可简写为 P）函数引用 CSV 文件:

假设 account.csv 在项目根目录的 data 目录下

config:name: "demo"testcases:testcase1_name:testcase: /path/to/testcase1parameters:username-password: ${P(data/account.csv)}

需要说明的是，在 parameters 中指定的参数名称必须与 CSV 文件中第一行的参数名称一致，顺序可以不一致，参数个数也可以不一致。

例如，在 account.csv 文件中可以包含多个参数，username、password、phone、age：

username,password,phone,age
test1,111111,18600000001,21
test2,222222,18600000002,22
test3,333333,18600000003,23
...
test1000,999999,18600000003,99

独立参数 & 引用自定义函数

当我们想要动态生成 100 个 user_id 的时候，我们可以使用 debugtalk.py 的自定义函数动态生成。

在 debugtalk.py 中定义函数：

def get_user_id():ret = []for nu in range(101):ret.append({"user_id": nu})return ret

然后，在 YAML/JSON 的 parameters 中就可以通过调用自定义函数的形式来指定数据源：

config:name: "demo"testcases:testcase1_name:testcase: /path/to/testcase1parameters:user_id: ${get_user_id()}

另外，通过函数的传参机制，还可以实现更灵活的参数生成功能，在调用函数时指定需要生成的参数个数。

关联参数 & 引用自定义函数

当我们想要动态生成 100 个账号的时候，我们可以使用 debugtalk.py 的自定义函数动态生成。

在 debugtalk.py 中定义函数：

def get_account(num):ret = []for nu in range(num):name = 'user-{}'.format(nu)pwd = 'pwd-{}'.format(nu)ret.append({"username": name,'password':pwd})return ret

那么在 YAML/JSON 的 parameters 中就可以调用自定义函数生成指定数量的参数列表:

config:name: "demo"testcases:testcase1_name:testcase: /path/to/testcase1parameters:username-password: ${get_account(10)}

数据驱动在 testsuite 中的 testcases 下使用关键字 parameters 定义，这些数据在 testcase 中的 teststeps 中使用关键字 variables 直接使用即可。

实例

测试项目源码

demo_api 文件：

name: demo api
variables:var1: value1var2: value2
request:url: /phygermethod: GETheaders:User-Agent: $user_agentContent-Type: "application/json"json:key: $var2username: $usernamepwd: $password

demo_api2 类似。

用例文件：

config:name: "demo testcase"variables:device_sn: "ABC"base_url: "https://getman.cn/mock"output: ["username","password"]teststeps:
-name: demo step 1api: api/demo_api.ymlvariables:user_agent: 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.97 Safari/537.36'device_sn: $device_snusername: $usernamepassword: $passwordvalidate:- eq: ["status_code", 200]setup_hooks:- ${hook_print(setup)}teardown_hooks:- ${hook_print(teardown)}
-name: demo step 2api: api/demo_api2.ymlvariables:token: ${get_token()}validate:- eq: [reason, OK]

测试套文件：

config:name: "demo testsuite"variables:device_sn: "XYZ"base_url: "http://127.0.0.1:5000"testcases:
-name: call demo_testcase with data 1testcase: testcases/demo_testcase.ymlvariables:device_sn: $device_snparameters:- username-password: ${get_account(10)}