Go 版 HttpRunner 介绍
背景
HttpRunner 最早是以 Python 实现的接口自动化测试框架,在社区里积累了大量用户。随着 Go 语言在后端和云原生领域的普及,HttpRunner 官方推出了 Go 版本(v4+),用 Go 重写了核心引擎,保留了 YAML/JSON 驱动的测试用例风格,同时带来了更小的体积、更高的并发能力和更好的部署体验。
项目地址:https://github.com/httprunner/httprunner
它是什么
Go 版 HttpRunner 是一个开源、协议无关的接口测试框架,核心特点:
- 用例即配置:用 YAML/JSON 描述 HTTP(S)、gRPC 等接口的测试步骤、断言、变量、参数化,无需写代码即可完成大部分测试。
- CLI 优先:一个
hrp二进制即可完成录制、转换、运行、生成报告、执行性能测试等常用操作。 - 支持多协议:HTTP(S)、HTTP/2、gRPC、TCP 等(借助插件和扩展)。
- 支持性能测试:内置基于
boomer的压测能力(与 Locust 生态兼容)。 - 工程化友好:单文件可执行,适合接入 CI/CD 与容器化运行。
安装与快速上手
安装
Bash
# macOS / Linux bash -c "$(curl -ksfL https://raw.githubusercontent.com/httprunner/install/master/install.sh)" # 或使用 go install go install github.com/httprunner/httprunner/v4@latest
安装后验证:
Bash
hrp -v
一个最小 HTTP 用例(YAML)
YAML
config:
name: "demo api test"
base_url: "https://httpbin.org"
variables:
username: "httprunner"
teststeps:
- name: "get with query"
request:
method: GET
url: "/get"
params:
name: $username
validate:
- check: status_code
assert: equals
expected: 200
- check: body.args.name
assert: equals
expected: "httprunner"
运行:
Bash
hrp run demo.yaml
用参数化做数据驱动:
YAML
config:
name: "param demo"
base_url: "https://httpbin.org"
parameters:
user: [alice, bob, carol]
teststeps:
- name: "get /get"
request:
method: GET
url: /get
params:
user: $user
validate:
- check: body.args.user
assert: equals
expected: $user
性能测试
Bash
hrp boom demo.yaml --spawn-count 50 --spawn-rate 5 --run-time 30s
得到与 Locust 类似的结果报表,可无缝接入现有的压测体系。
录制与转换
Bash
# 录制 HTTP 流量生成用例 hrp record --save-tests ./recorded # 将 HAR 转为测试用例 hrp convert --from-har x.har --to-yaml
典型使用场景
- 接口回归测试:YAML 管理用例,接入 CI,运行
hrp run cases/即可。 - 数据驱动测试:
parameters支持笛卡尔积、CSV 引用等,方便做多组合验证。 - 性能压测:用同一份用例做功能与性能双用。
- 混沌/混合协议测试:通过插件机制扩展协议(例如 WebSocket、TCP、DNS 等)。
与 Python 版本的关系
| 维度 | Python 版 | Go 版(v4+) |
|---|---|---|
| 运行时 | 需要 Python 环境 | 单二进制 |
| 性能 | 中等 | 更高 |
| 生态/插件 | 最丰富 | 逐步完善,支持插件 |
| 用例 YAML 兼容 | 是 | 大体兼容,部分字段有所调整 |
如果你是存量 Python 用户,迁移时主要注意 teststeps 字段结构(v4 使用 request 而非 api/method 直接平铺)以及断言写法(validate 的 check/assert/expected 结构)。
工程实践建议
- 目录规范:
config/放公共变量与 host,testcases/放单接口用例,testsuites/组合用例。 - 环境隔离:利用
--venv/ENV 变量或 config 中的base_url覆盖,避免硬编码 host。 - 报告产出:
hrp run --gen-html-report生成 HTML 报告;配合--save-tests留存运行产物用于排障。 - CI 集成:以容器方式运行
httprunner/httprunner:latest,缩短环境准备时间。 - 断言分层:优先断言
status_code和关键字段,避免过度耦合响应结构。
总结
Go 版 HttpRunner 把「YAML 描述用例 + 单二进制执行」的组合做得很扎实:既能满足日常接口自动化,也覆盖了压测与多协议扩展,落地成本低。对需要把测试能力嵌入流水线、又不想维护 Python 环境的团队来说,它是一个很值得上手的方案。
httprunner_20261108050953.zip
类型:压缩文件|已下载:0|下载方式:免费下载
立即下载




还没有评论,来说两句吧...