接口测试利器 HttpRunner 全面解析

HttpRunner 是一款面向测试开发的开源接口自动化测试框架，支持 YAML/JSON/Python 编写测试用例，支持 CLI 和 Python 代码运行，兼容多种主流工具（如 Allure、Jenkins 等），非常适合自动化测试团队使用。

随着微服务、前后端分离架构的普及，接口自动化测试 在软件测试领域变得越来越重要。市面上有诸多接口测试工具和框架可供选择，而其中一款国产开源、功能强大的工具——HttpRunner，因其脚本简单、功能完善、适合 CI/CD 接入等优势，广受国内测试工程师欢迎。

一、HttpRunner 简介

HttpRunner 是一个功能强大、易于使用的开源接口测试框架，支持 HTTP(S)、WebSocket 协议，兼容 API 测试和性能测试，适合各种测试场景：

• 支持 YAML / JSON / Python 多种测试用例格式

• 支持测试数据参数化、断言机制、测试用例复用

• 与pytest、Allure深度集成

• 支持 CI/CD 集成，适合企业自动化流程

它的设计理念是“测试即代码，代码即测试”，不仅适合功能测试，也非常适合接口自动化开发。

官方地址：

• GitHub： https://github.com/httprunner/httprunner

• 文档： https://httprunner.com

二、与其他接口测试工具对比

HttpRunner 是一种中间路线，兼具易用性（使用YAML编写用例）与 灵活性（使用Python编写用例），非常适合团队接口测试自动化落地。

三、HttpRunner 版本演进

HttpRunner 自 2017 年发布以来，经历了多个重大版本升级，不断提升其功能、稳定性与可扩展性。

以下版本对比来自官方文档：

四、HttpRunner安装和使用

HttpRunner 追求“简单易用”，即使是新用户，也能在 10 分钟内快速跑通第一个接口自动化用例。

一、安装部署

HttpRunner v4 采用 Go 语言开发，已提供跨平台二进制安装包。安装只需一条命令：

bash -c "$(curl -ksSL https://httprunner.com/script/install.sh)"

AI写代码

安装完成后，你将获得命令行工具hrp，通过下面命令查看帮助：

hrp -h

AI写代码

示例输出（简略）：​​​​​

1. Usage:

2. hrp [command]

3. Available Commands:

4. boom run load test with boomer

5. convert convert JSON/YAML testcases to pytest/gotest scripts

6. har2case convert HAR to json/yaml testcase files

7. pytest run API test with pytest

8. run run API test with go engine

9. startproject create a scaffold project

10. ...

二、创建项目脚手架

执行以下命令初始化一个示例项目，项目目录结构自动生成：

hrp startproject demo

AI写代码

示例输出日志会显示创建过程，完成后你会看到：

1. demo/

2. ├── .env

3. ├── .gitignore

4. ├── debugtalk.py

5. ├── har/

6. │ └── .keep

7. ├── reports/

8. │ └── .keep

9. └── testcases/

10. ├── demo_requests.yml

11. ├── demo_ref_testcase.yml

12. └── demo_with_funplugin.json

• testcases/：存放测试用例

• debugtalk.py：自定义函数脚本

• reports/：测试报告目录

三、快速预览测试用例

以demo_requests.yml为例，里面包含多个 HTTP 请求测试步骤。

示例节选：

1. config:

2. name: "request methods testcase with functions"

3. base_url: "https://postman-echo.com"

4. variables:

5. foo1: config_bar1

6. foo2: config_bar2

7. expect_foo1: config_bar1

8. expect_foo2: config_bar2

9. verify: False

10. export: ["foo3"]

11. teststeps:

12. - name: get with params

13. variables:

14. foo1: bar11

15. foo2: bar21

16. sum_v: "${sum_two(1, 2)}"

17. request:

18. method: GET

19. url: /get

20. params:

21. foo1: $foo1

22. foo2: $foo2

23. sum_v: $sum_v

24. headers:

25. User-Agent: HttpRunner/${get_httprunner_version()}

26. extract:

27. foo3: "body.args.foo2"

28. validate:

29. - eq: ["status_code", 200]

30. - eq: ["body.args.foo1", "bar11"]

31. - eq: ["body.args.sum_v", "3"]

32. - eq: ["body.args.foo2", "bar21"]

说明：

• config定义全局配置，如基本 URL、变量、SSL 校验等。

• teststeps是有序的测试步骤列表，每步代表一个 HTTP 请求和校验

• 变量支持定义和覆盖，支持${函数名(参数)}调用自定义函数。

• 断言（validate）用于校验返回状态码和响应体字段。

四、自定义函数示例（debugtalk.py）

debugtalk.py允许你定义业务相关的函数，并在 YAML 中调用。

示例代码：

1. import funppy

2. def get_httprunner_version():

3. return "v4.0.0-alpha"

4. def sum_two_int(a: int, b: int) -> int:

5. return a + b

6. if __name__ == '__main__':

7. funppy.register("get_httprunner_version", get_httprunner_version)

8. funppy.register("sum_two", sum_two_int)

9. funppy.serve()

• 通过funppy.register注册函数后，YAML 用例就能调用${sum_two(1,2)}。

• 这是基于“约定优于配置”的设计，方便逻辑复用。

五、运行接口测试

执行以下命令，运行项目中的测试用例，并生成 HTML 报告：

hrp run demo/testcases/demo_requests.yml demo/testcases/demo_ref_testcase.yml --gen-html-report

AI写代码

AI写代码

• 支持同时运行多个用例文件

• --gen-html-report会在reports/目录生成可视化测试报告

六、查看测试报告

打开reports/目录中生成的 HTML 文件，浏览器打开后即可查看：

• 每条用例请求和响应详情

• 断言结果和错误信息

• 用例执行耗时、状态统计

七、性能压测（Boomer）

利用已有接口用例，快速做性能压测，无需额外改造。

示例命令：

hrp boom demo/testcases/demo_requests.yml --spawn-count 100 --spawn-rate 10

AI写代码

• --spawn-count：并发用户数

• --spawn-rate：每秒启动用户数

• 压测过程实时输出统计数据

感谢每一个认真阅读我文章的人！！！

作为一位过来人也是希望大家少走一些弯路，如果你不想再体验一次学习时找不到资料，没人解答问题，坚持几天便放弃的感受的话，在这里我给大家分享一些自动化测试的学习资源，希望能给你前进的路上带来帮助。

软件测试面试文档

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

视频文档获取方式：
这份文档和视频资料，对于想从事【软件测试】的朋友来说应该是最全面最完整的备战仓库，这个仓库也陪伴我走过了最艰难的路程，希望也能帮助到你！以上均可以分享，点下方小卡片即可自行领取。